@adobe/design-data-agent-mcp

MCP 服务器和 Claude 代码技能 光谱设计数据 探员表面 读取工具( E)primer, (中文(简体) ), resolve_token, (中文(简体) ), query_tokens, (中文(简体) ), suggest_token, (中文(简体) ), describe_component, (中文(简体) ), describe_guideline, (中文(简体) ), list_guidelines)通过 @adobe/design-data-wasm ——这些不需要CLI二进制. suggest_token 使用相片 suggest API 直接; authoring_session_step_intent 仍然引用本地二进制来进行一个写作流中的会话-状态-意识排名.

测试准则内容

运行 moon run design-data-agent-mcp:test仅对包装内容合同, 之后 moon run sdk-wasm:build,运行 :

pnpm --filter @adobe/design-data-agent-mcp exec ava test/packaged-guidelines.test.js

套间用 pnpm pack 以测试代理文件,提取 将柏油球打入一棵新鲜的私人树上 mCPB 包装许可列表。 它在 Stdio 上初始化已打包的服务器 没有数据覆盖, 检查目录与条子表, 比较 对源 JSON 的每一个指南响应, 并检查无效的粘错 。 导入 警卫拒绝无害环境管理的进口,而普通JS则要求在私人树外.

依赖来自当地建筑,而不是注册柏油丸,所以这不是一种 注册-安装测试。 它不评估模型答案的质量。 测试取消 之后是私人植树.

安装

Claude代码(技能+可选 MCP)

添加 Spectrum 设计数据市场,然后安装 spec-generic 技能 :

/plugin marketplace add adobe/spectrum-design-data
/plugin install design-data-agent@spectrum-design-data

对于零设置(嵌入式快照)的光谱符号,安装 design-data@spectrum-design-data 相反——见 tools/design-data-skill/。 。 。 .

光标( 技能)

光标设置 规则 添加规则 → 远程规则 (GitHub) - 贴:

https://github.com/adobe/spectrum-design-data/tree/main/tools/design-data-agent-mcp/skills/design-data

npm (MCP 服务器)

npx @adobe/design-data-agent-mcp@latest

这个 design-data CLI 二进制( 0. 13. 0 或更新) 需要 authoring_session_step_intent 以及何时 DESIGN_DATA_CONFIG 因为平台级联运行 design-data catalog export。所有其他工具都在运行中。 与 Homebrew 安装 :

brew tap adobe/spectrum-design-data https://github.com/adobe/spectrum-design-data
brew install adobe/spectrum-design-data/design-data

设定 DESIGN_DATA_BIN 如果二进制没有打开 PATH。 。 。 .

保持当前状态

嵌入式光谱快照在建时被烘烤入被子场并随同出行 软件包版本——没有单独的数据更新可以运行. 键 @latest (如上所述) npx 获取最新发布的版本, 而不是重用它上次缓存的任何内容 ; -y 一个人 只跳过安装确认,它不会强制重排. 已经开始了 /plugin运行 /plugin update design-data-agent@spectrum-design-data并检查 provenance.designDataVersion 以查看哪些数据集版本已嵌入。 初级工具 并对照最近公布的 @adobe/spectrum-design-data 版本——如果嵌入式数据集落后,则会添加一个 provenance.datasetStatus 字段和 将单行警告记录为 stderr 。 对于任何网络故障(离线/空载)都保持沉默 使用不受影响; 设置 DESIGN_DATA_SKIP_VERSION_CHECK=1 要完全禁用检查.

MCP 服务器

配置要运行的 MCP 客户端 :

npx -y @adobe/design-data-agent-mcp@latest

或从回波克隆:

node tools/design-data-agent-mcp/src/index.js

环境变量

平台级联. 若为 DESIGN_DATA_CONFIG 设置,服务器 shells 发送到 页:1 design-data 启动时 CLI 一次 (单位:千美元)design-data query --filter "" --format json,从配置目录中运行) 联合国 .design-data.toml 源(路径/npm/github/git)及其顶层 manifest 级联或, 若为 DESIGN_DATA_PLATFORM 被设定,该名称为 [platforms.<id>] 条目 明显——反映CLI本身 --platform编号 :DESIGN_DATA_PLATFORM,则 将结果变为临时目录和分数 primer 编号 : resolve_token 编号 : query_tokens 编号 : validate_usage 编号 : describe_component 编号 : describe_guideline 编号 : list_guidelines 在它而不是嵌入 光谱快照. 构成部分和准则目录来自 design-data catalog export --out <dir> [--platform <id>],所以扩展 组件、执行行和替换来自SDK级联 (这需要 design-data 较新于0.12.1。 关系还在复制中 从倒计时数据集 并覆盖 平台显示扩展。 若为 解析失败 (例如没有github源的网络),服务器记录一个警告并掉入 返回嵌入式/局部数据集而不是崩溃.

路径解析. MCP 客户端用工作程序启动此服务器 从编辑器打开的地方继承的目录——可以是 您 repo 的子目录( 例如 ). sdk/),而不是还原根. 保持独立 在该工作目录中,每个数据路径按以下顺序解决:

1. 明确的内涵覆盖. 若为 DESIGN_DATA_PATH 编号 : DESIGN_DATA_COMPONENTS 编号 : DESIGN_DATA_FIELDS 已设定,它被使用。 相对值定位于 DESIGN_DATA_ROOT (绝对,在通过 npx或,如果 那是未设置的, 到服务器软件包在单列波中自己的位置 。 绝对 值作为正值使用.
2. 决定 @adobe/spectrum-design-data 软件包 (0个配置). 没有潜入时 设置了覆盖, 服务器解决已安装 @adobe/spectrum-design-data 通过节点模块解析并读取其 tokens/, (中文(简体) ), components/,以及 fields/ 目录. 在 pnpm 工作空间中,这跟随符号链接到 packages/design-data;发布时使用已安装的依赖性. 这个 独立于工作目录.
3. 倒倒倒地来. dataPath 返回当前目录 组件/字段覆盖返回到 null (未提供),这意味着 describe_component 编号 : describe_guideline 如果 @adobe/spectrum-design-data 无法解决.

在单列票房中,您通常不需要 DESIGN_DATA_* 完全没有.. 通过工作空间软件包实现解析.

示例( 菜单) .cursor/mcp.json(中文(简体) )

{
  "mcpServers": {
    "design-data-agent": {
      "command": "npx",
      "args": ["-y", "@adobe/design-data-agent-mcp@latest"],
      "env": {
        "DESIGN_DATA_ROOT": "/abs/path/to/your/repo",
        "DESIGN_DATA_PATH": "packages/design-data/tokens",
        "DESIGN_DATA_COMPONENTS": "packages/design-data/components",
        "DESIGN_DATA_FIELDS": "packages/design-data/fields"
      }
    }
  }
}

示例( 隐藏桌面) claude_desktop_config.json(中文(简体) )

{
  "mcpServers": {
    "design-data-agent": {
      "command": "npx",
      "args": ["-y", "@adobe/design-data-agent-mcp@latest"],
      "env": {
        "DESIGN_DATA_BIN": "design-data",
        "DESIGN_DATA_PATH": "/path/to/your/dataset"
      }
    }
  }
}

已曝光的工具

技能

克劳德密码的技巧住在 skills/design-data/SKILL.md它向外发射 npx @adobe/design-data 对本地数据集进行验证、查询、解析、diff和写入操作.

许可证

阿帕奇 - 2.0