aurum-mcp

LLMクライアントからAurumデザインシステムを操作しましょう。 コンポーネント、トークン、アイコン、FigmaノードID、変更履歴など、すべてをClaude Code、Cursor、Copilot CLI、Gemini、Claude Desktopからクエリ可能です。

aurum-mcpは、AurumデザインシステムのカタログをLLMに提供するModel Context Protocolサーバーです。バンドルされたJSONマニフェスト（changejarapp.github.io/aurum-androidから自動同期）を読み込み、LLMが以下のような質問に回答するための9つのツールを公開します。

• 「AurumChipの使い方を教えて。」

• 「ネガティブフィードバック用のテキストにはどのカラートークンを使えばいい？」

• 「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のみを使用します。

バージョニング

デフォルトのスニペットでは、常に最新の安定版を指すCI管理のGitタグ#latest-stableを使用しています。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を参照してください。

なぜnpmではなくnpx-from-Gitなのか？

私たちは3つの配布チャネル（公開npm、GitHub Packages、npx-from-Git）を検討し、シンプルさ、完全な所有権、新しいインフラの構築不要を最適化するために3番目を選択しました：

• 管理すべき新しいアカウントがゼロ。 npm組織も、NPM_TOKENのローテーションも、2FAの復旧も、72時間ごとの公開永続性の懸念もありません。リポジトリ自体がエンドツーエンドの成果物となります。

• ブランチベースのテストが無料。 フィーチャーブランチを試したい場合は、スニペットを#feat/branch-nameに変更するだけです。npmの場合、レジストリに永遠に残るプレリリース版を公開する必要があります。

• 既存の認証を利用可能。 このリポジトリは公開されており、チームメンバーはGitHubアクセス権を持っているため、新しい設定は不要です。

• インストール時のわずかな遅延。 初回起動時はクローン＋ビルドで約5〜10秒かかりますが、npmでも約2〜5秒かかります。キャッシュされた起動は同一です。

受け入れるトレードオフ：バージョン固定のUXがやや劣る（Gitタグ vs セマンティックバージョニング）ことと、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スクリプトは、単一のパーサーセットからコンポーネント、トークン、アイコン、Code Connectマッピング、変更履歴を集約します。私たちは、同じデータの構造化されたJSONプロジェクションを生成する--emit-manifestフラグを追加しました。契約はaurum-android内のtooling/manifest/schema.jsonです。このMCPサーバーはそのJSONの読み取り側であり、起動時にマニフェストを読み込んでインデックス化し、上記の9つのツールを提供します。単一の信頼できる情報源に対し、2つのレンダリングターゲット（人間用のHTML、エージェント用のJSON）が存在します。aurum-iosがリリースされた際は、そのマニフェストを兄弟ソースとしてプラグインするだけで済みます。MCPコードはプラットフォームに依存しません。

パイプラインの全体図：docs/architecture.md。

貢献

IssueやPRを歓迎します。ワークフロー（マニフェスト同期、ドリフトチェック、リリースプロセス）についてはdocs/contributing.mdを参照してください。コードスタイル：TypeScript strict、Prettierデフォルト。Markdownフォーマッタにビジネスロジックを含めないこと。

ライセンス

MIT — LICENSEを参照してください。