# @adobe/spectrum-design-data-mcp 中文文档

规范地址：https://npmcn.com/package/%40adobe/spectrum-design-data-mcp/

版本：1\.1\.93
npm 元数据更新时间：2026-11-07T03:11:35.154Z
中文译文更新时间：2026-11-08T09:59:37.329Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adobe/spectrum-design-data-mcp
原文对照：https://npmcn.com/package/%40adobe/spectrum-design-data-mcp/?lang=original
项目主页：https://github.com/adobe/spectrum-design-data/tree/main/tools/spectrum-design-data-mcp#readme
源码仓库：https://github.com/adobe/spectrum-design-data

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：82.5 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.12\.0
- 运行依赖：4 个
- 首次发布：2025-08-20T21:15:42.732Z
- 最新版本发布：2026-11-07T03:11:34.789Z
- 近 30 天下载量：1811（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：116（近 12 个月 104 个）

## 中文简介

DEPRECATED——取而代之的是 @adobe/dedesign-data-mcp(正在处理中). 用于 Spectrum 设计数据,包括令牌、图案和组件解剖学的模拟上下文协议服务器

## 安装

```sh
npm install @adobe/spectrum-design-data-mcp
```

也可以使用：`pnpm add @adobe/spectrum-design-data-mcp`、`yarn add @adobe/spectrum-design-data-mcp`、`bun add @adobe/spectrum-design-data-mcp`

## README

# 光谱设计数据 MCP 服务器

> **已贬值** ——本套计划不再积极维护. 新项目应使用 [`@adobe/design-data-mcp`](https://www.npmjs.com/package/@adobe/design-data-mcp) 相反, 它通过原地运行,是积极维护的接班人。 请注意: `@adobe/design-data-mcp` 这不是一个即时替换——它有不同的工具名称,而且确实 不包括 `query-tokens-by-value`, (中文(简体) ), `validate-component-props`,或组件 --schema 工具。 此软件包仍然可供后向兼容, 但不会收到新的 特性.

一个模型上下文协议(MCP)服务器,提供AI工具有结构化访问Adobe Spectrum设计系统数据,包括设计符和组件API schemas.

## 概览

这个MCP服务器使AI助手能够通过标准化协议查询并和Spectrum设计数据互动. 它提供下列渠道:

-   **设计托肯斯**: 彩色调色板、打字、布局符号和语义符号
-   **组件外观**: Spectrum 组件的 API 定义和验证方案
-   **未来**: 组件解剖、设计模式和准则

## 先决条件

-   **节点.js 20+**

为了兼容性,令牌工具通过 Cononic 嵌入式数据集投影 `@adobe/design-data-wasm` 而不是读取生成的遗留符号文件 . 工具名和响应形状不变. 这个包裹仍然是被贬损的. 工作空间发展需要 `moon run sdk-wasm:build` 在测试之前.

## 安装

```bash
npm install -g @adobe/spectrum-design-data-mcp
```

### 验证软件包完整性

这个软件包以npm出处发布,以加强供应链安全。 您可以验证包裹的证明:

```bash
npm audit signatures
```

或者克隆并在当地运行 :

```bash
git clone https://github.com/adobe/spectrum-design-data.git
cd spectrum-design-data/tools/spectrum-design-data-mcp
pnpm install
```

## 使用量

### 启动 MCP 服务器

```bash
# Start the server (default command)
spectrum-design-data-mcp

# Or explicitly start
spectrum-design-data-mcp start
```

服务器在当地运行,并通过stdio与MCP兼容的AI客户端进行通信.

### 可用工具

#### 调试工具

-   **`query-tokens`**: 按名称、类型或类别搜索光谱符号
-   **`query-tokens-by-value`**: 以直接或已解析的值查找符号( 随同别名)
-   **`get-token-details`**: 获取关于特定标志的详细信息
-   **`get-component-tokens`**: 获取组件名称的所有符号

#### Schema 工具

-   **`list-components`**: 列出现有组件(无计划有效载荷)
-   **`get-component-schema`**: 一个组件的完整计划
-   **`validate-component-props`**: 对照计划验证道具
-   **`search-components-by-feature`**: 按属性名称查找组件

## 配置

### MCP 设置

添加到您的 MCP 配置( 例如 ), `.cursor/mcp.json` 光标 IDE :

#### 备选案文1:使用npx(建议)

```json
{
  "mcpServers": {
    "spectrum-design-data": {
      "command": "npx",
      "args": ["-y", "@adobe/spectrum-design-data-mcp"]
    }
  }
}
```

#### 备选方案2:使用全球安装

```json
{
  "mcpServers": {
    "spectrum-design-data": {
      "command": "@adobe/spectrum-design-data-mcp"
    }
  }
}
```

#### 备选办法3:地方发展

```json
{
  "mcpServers": {
    "spectrum-design-data": {
      "command": "node",
      "args": [
        "./path/to/spectrum-design-data/tools/spectrum-design-data-mcp/src/index.js"
      ]
    }
  }
}
```

> **说明**: 使用 `npx` 建议采用(备选案文1),因为它避免了路径选择问题,并确保您总是使用最新版本。 这个方法与浏览器MCP等其它MCP服务器相仿并解决了常见的NPX可用性问题.

### Claude 桌面 (Legacy 配置)

对于更古老的克洛德桌面配置:

```json
{
  "mcpServers": {
    "spectrum-design-data": {
      "command": "spectrum-design-data-mcp",
      "args": []
    }
  }
}
```

### 其他MCP客户端

服务器使用stdio可运输并遵循MCP规格. 请查看您的客户端的文档以了解配置细节 .

## 实例

### 构筑工作流程

#### 特定部件

```
Human: Show me all available button-related design tokens.

AI: I'll gather all button-related tokens from the Spectrum system.

[Uses get-component-tokens with componentName="button"]

Found button-related tokens across categories:
- Color tokens: floating-action-button colors
- Layout tokens: button sizing, padding, spacing
- Examples: radio-button-control-size-small, action-button-edge-to-hold-icon...
```

#### 按数值查找托肯

```
Human: Which tokens resolve to 1px?

AI: I'll search for tokens whose value is 1px (direct or alias).

[Uses query-tokens-by-value with value="1px"]

Tokens with value 1px:
- border-width-100 (direct)
- picker-border-width (alias to border-width-100)
```

### 调试

#### 查询颜色托肯斯

```
Human: What blue color tokens are available in Spectrum?

AI: I'll search for blue color tokens in the Spectrum design system.

[Uses query-tokens tool with query="blue" and category="color"]

The Spectrum design system includes several blue color tokens:
- spectrum-blue-100: #e6f3ff
- spectrum-blue-200: #b3d9ff
- spectrum-blue-300: #80bfff
...
```

#### 验证组件道具

```
Human: Is this button configuration valid according to Spectrum?

AI: I'll validate those button properties against the Spectrum schema.

[Uses validate-component-props tool with component="action-button"]

The configuration is valid! All required properties are present and the types match the expected schema.
```

## 解决问题

### 安装问题

```bash
# Check Node.js version
node --version  # Should be 20+

# Clear npm cache if needed
npm cache clean --force

# Verify package installation
npm list -g @adobe/spectrum-design-data-mcp
```

### MCP 连接问题

1.  验证 MCP 配置文件路径
2.  请检查node.js 路径是否正确
3.  确保软件包在全球安装或使用npx
4.  配置更改后重新启动您的AI客户端

### 软件包验证

```bash
# Verify package integrity
npm audit signatures

# Check for security vulnerabilities
npm audit
```

## 发展

### 来源建筑

```bash
git clone https://github.com/adobe/spectrum-design-data.git
cd spectrum-design-data
pnpm install
cd tools/spectrum-design-data-mcp
```

### 测试

```bash
pnpm test
```

### 项目结构

```
src/
├── index.js              # Main MCP server
├── cli.js               # CLI interface
├── tools/               # MCP tool implementations
│   ├── tokens.js        # Token-related tools
│   └── schemas.js       # Schema-related tools
└── data/                # Data access layer
    ├── tokens.js        # Token data access
    └── schemas.js       # Schema data access
```

## 警卫

### 供应链安全

-   **国家防范机制证明**:用npm出处公布的可核查建筑证明
-   **安全审计**: 定期依赖性安保审计
-   **\* 已验证的软件包**:所有依赖性都经过审计和核实

### 最佳做法

-   总是使用 `npm audit signatures`
-   将软件包更新到最新版本
-   使用 `npx -y` 最安全和最新的处决
-   安保问题报告 [GitHub 安全咨询](https://github.com/adobe/spectrum-design-data/security/advisories)

## 许可证

Apache-2.0 阿多贝

## 捐款

这个项目是光谱设计系统的一部分. 请看主线 [捐款准则](https://npmcn.com/package/CONTRIBUTING.md) 详细介绍如何捐款.

## 支助

-   创建一个 [问题](https://github.com/adobe/spectrum-design-data/issues) 用于错误报告或特性请求
-   检查 [文档](https://github.com/adobe/spectrum-design-data/tree/main/tools/spectrum-design-data-mcp) 详细指南
-   审查 [现有问题](https://github.com/adobe/spectrum-design-data/issues?q=label%3Amcp) 解决方案

## 常见问题

### @adobe/spectrum-design-data-mcp 是什么？

DEPRECATED——取而代之的是 @adobe/dedesign-data-mcp\(正在处理中\)\. 用于 Spectrum 设计数据,包括令牌、图案和组件解剖学的模拟上下文协议服务器

### 如何安装 @adobe/spectrum-design-data-mcp？

在项目目录运行 npm install @adobe/spectrum-design-data-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 spectrum-design-data-mcp，可以用 npx spectrum-design-data-mcp 直接运行。

### @adobe/spectrum-design-data-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe\_\_spectrum-design-data-mcp 是否存在。

### @adobe/spectrum-design-data-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adobe/spectrum-design-data-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adobe/spectrum-design-data-mcp 可以商用吗？

@adobe/spectrum-design-data-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @adobe/spectrum-design-data-mcp 的下载量有多少？

根据 npm 官方下载统计，@adobe/spectrum-design-data-mcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,811 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adobe/spectrum-design-data-mcp 还在维护吗？

最新版本 1\.1\.93 发布于 2026/11/07（1 天前）；至今共发布 116 个版本，其中过去 12 个月发布了 104 个；首次发布于 2025/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。