aurum-mcp

从你的 LLM 客户端与 Aurum 设计系统 对话。 组件 · Token · 图标 · Figma 节点 ID · 更新日志 — 全部可从 Claude Code、Cursor、Copilot CLI、Gemini 和 Claude Desktop 查询。

aurum-mcp 是一个 Model Context Protocol 服务器，它将 Aurum 设计系统目录呈现给 LLM。它读取一个捆绑的 JSON 清单（从 changejarapp.github.io/aurum-android 自动同步），并公开 9 个工具，LLM 可以调用这些工具来回答如下问题：

• “展示如何使用 AurumChip。”

• “我们有什么用于负面反馈文本的颜色 Token？”

• “AurumTopAppBar 的 Figma 节点是什么？”

• “给我找一个返回箭头的图标。”

• “最近一次发布有什么变化？”

安装（一次粘贴，适用于所有客户端）

在下方选择你的客户端，将代码片段粘贴到对应的配置文件中，然后重启客户端。

Claude Code（项目根目录下的 .mcp.json，或 ~/.claude.json）

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Copilot CLI (~/.copilot/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Gemini CLI (~/.gemini/settings.json 中的 mcpServers 下)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

结构相同 — 将上述片段放入 mcpServers 中。重启应用即可。

就是这样。无需 npm 注册表，无需 ~/.npmrc，无需 PAT，无需环境变量。 公开 Git，公开 npx。

版本控制

默认片段使用 #latest-stable — 这是一个由 CI 管理的 Git 标签，始终指向最新的稳定版本。其行为类似于 npm 的 @latest 发行标签：你在每次 npx 缓存失效时都会获得自动更新（取决于你的客户端缓存，大约 10 分钟到几小时不等）。

为了可复现性（自动化脚本、审计设置），请锁定到明确的标签：

"args": ["-y", "github:atri-jar/aurum-mcp#v0.1.0"]

aurum-mcp 的每个版本都附带了来自对应 Aurum 库版本的清单（@aurum-mcp:0.1.6 ⇄ aurum:0.1.6）。从你的 LLM 客户端调用 get_aurum_version 以查看你当前连接的具体版本。

工具

请参阅 docs/tools.md 获取完整的输入模式和示例响应。

为什么选择 npx-from-Git 而不是 npm？

我们考虑了三种分发渠道（公共 npm、GitHub Packages、npx-from-Git），并选择了第三种，因为对于一个优化了简洁性、完全所有权和零新基础设施的团队内部工具而言：

• 无需管理新账户。 无需 npm 组织，无需轮换 NPM_TOKEN，无需 2FA 恢复，无需担心 72 小时发布持久性。仓库本身就是制品，端到端。

• 免费的基于分支的测试。 想尝试一个功能分支？只需将片段更改为 #feat/branch-name 即可。使用 npm，你必须发布一个预发布标签，它将永远存在于注册表中。

• 用户已有的身份验证。 该仓库是公开的；团队成员拥有 GitHub 访问权限；无需配置任何新内容。

• 微小的安装延迟。 首次启动大约需要 5–10 秒的克隆 + 构建，而 npm 大约需要 2–5 秒。缓存后的启动速度相同。

我们接受的权衡：版本锁定体验较不完善（Git 标签 vs. semver 范围），且没有公共 npm 的可发现性。完整的理由在 docs/architecture.md 中。

本地开发

git clone https://github.com/atri-jar/aurum-mcp.git
cd aurum-mcp
pnpm install
pnpm dev          # run the server via tsx + stdio
pnpm inspect      # spawn the official MCP Inspector UI
pnpm build        # tsc → dist/
pnpm smoke        # end-to-end tools/list + tools/call test

服务器读取 data/manifest.json（已提交）。要从实时 Aurum 画廊拉取最新清单并更新捆绑副本：

make manifest-fetch

CI 会自动执行此操作（请参阅 .github/workflows/sync-manifest.yml）。

架构概述

Aurum 设计系统位于 Changejarapp/aurum-android（私有），并在 changejarapp.github.io/aurum-android 发布了一个公共画廊。其 tooling/gallery/generate.py 脚本从一组解析器中聚合组件、Token、图标、Code Connect 映射和更新日志。我们添加了一个 --emit-manifest 标志，用于生成相同数据的结构化 JSON 投影 — 契约是 aurum-android 中的 tooling/manifest/schema.json。此 MCP 服务器是该 JSON 的读取端：它在启动时加载清单、建立索引并提供上述 9 个工具。单一事实来源，两个渲染目标（面向人类的 HTML，面向代理的 JSON）。当 aurum-ios 发布时，其清单将作为同级源插入 — MCP 代码与平台无关。

完整流水线图：docs/architecture.md。

贡献

欢迎提交 Issue 和 PR。请参阅 docs/contributing.md 了解工作流程（清单同步、漂移检查、发布流程）。代码风格：TypeScript 严格模式，Prettier 默认设置；Markdown 格式化程序中不包含业务逻辑。

许可证

MIT — 请参阅 LICENSE。