125k

MCP サーバー

PreviousNext

レジストリ開発者向けの MCP サポート

shadcn MCP サーバーは shadcn 互換のレジストリであればそのまま動作します。レジストリ側で MCP サポートを有効にするために特別な対応は不要です。

前提条件

MCP サーバーはレジストリインデックスをリクエストして動作します。レジストリのルートに registry という名前のレジストリアイテムファイルがあることを確認してください。

たとえば、レジストリが https://acme.com/r/[name].json でホストされている場合、https://acme.com/r/registry.json にファイルが必要です。JSON 拡張子を使わない形式の場合は https://acme.com/r/registry にファイルを配置してください。

このファイルはレジストリスキーマに準拠した有効な JSON ファイルでなければなりません。

MCP の設定

レジストリ利用者に対し、components.json ファイルでレジストリを設定し、shadcn MCP サーバーをインストールするよう案内してください:

components.json ファイルでレジストリを設定します:

components.json
{
  "registries": {
    "@acme": "https://acme.com/r/{name}.json"
  }
}

プロジェクトで以下のコマンドを実行します:

pnpm dlx shadcn@latest mcp init --client claude

Claude Code を再起動して、以下のプロンプトを試してください:

  • Show me the components in the acme registry
  • Create a landing page using items from the acme registry

注意: Claude Code では /mcp コマンドで MCP サーバーをデバッグできます。

MCP サーバーの詳細は MCP ドキュメントをご覧ください。

ベストプラクティス

MCP 対応レジストリ向けのベストプラクティスを紹介します:

  1. 明確な説明: AI アシスタントがレジストリアイテムの用途や使い方を理解できるよう、簡潔で分かりやすい説明を追加します。
  2. 適切な依存関係: MCP が自動インストールできるよう、すべての dependencies を正確に列挙します。
  3. レジストリ依存関係: アイテム間の関係を示すために registryDependencies を使用します。
  4. 一貫した命名: コンポーネント名には kebab-case を使い、レジストリ全体で一貫性を保ちます。