Shadcn Registry Mcp Server

shadcn registry manager - MCP サーバー

このプロジェクトは、shadcn/ui コンポーネントレジストリと CLI 用の MCP（Model Context Protocol）サーバーを提供します。通常はローカルで実行する shadcn CLI コマンド（init、add など）を、リモート環境やプログラム、コンテナ内から実行できるため、クラウド／開発環境での自動化や統合、実行が簡単になります。この MCP サーバーは、ローカルとリモートの両方の shadcn レジストリに接続でき、AI や CLI エージェントを介してプロジェクト管理タスクを自動化するための、安全で拡張可能な技術インターフェースを提供します。

できること

この MCP サーバーは、shadcn CLI の操作を MCP ツールとして公開するため、以下の操作ができます。

• プロジェクトを初期化する
• shadcn レジストリからコンポーネントを追加する（ブロックコンポーネントを含む）
• レジストリアイテムを一覧表示して取得する
• shadcn CLI のすべてのワークフローをリモートで実行する
• 公式の shadcn レジストリ（https://ui.shadcn.com/r）と**カスタム／セルフホスト可能なレジストリ**の両方をサポートします。こちらのガイドに従ってください：https://ui.shadcn.com/docs/blocks

使用方法

Docker

プロジェクトディレクトリをマウントして、MCP サーバーをコンテナ内で実行します。

以下を mcp.json ファイルに追加します。

   "shadcn-registry-manager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount",
        "type=bind,src=<your-project-path>,dst=/workspace",
        "-e", 
        "REGISTRY_URL=https://ui.shadcn.com/r",
        "-e", 
        "STYLE=new-york",
        "reuvenaor/shadcn-registry-manager"
      ],
    },

Docker のマウントについて：

• <your-project-path> - プロジェクトディレクトリへのパスです。

  例：/Library/Projects/shadcn-registry-manager/www

• /workspace - コンテナ内のワークスペースディレクトリへのパスです。 (変更しないでください。変更した場合は、すべてのツール呼び出しで同じパスを cwd パラメーターとして渡す必要があります)

Docker の環境変数：

• REGISTRY_URL
  • オプション 1：https://ui.shadcn.com/r - shadcn レジストリの URL
  • オプション 2：http://localhost:3000>/r - 独自のレジストリサーバーの URL（こちらのガイドに従ってください：https://ui.shadcn.com/docs/blocks）
• STYLE - shadcn レジストリのスタイルです - new-york

npx

ローカル開発や CI/CD パイプラインに便利な npx を使用して、MCP サーバーを実行することもできます。

以下を mcp.json ファイルに追加します。

  "shadcn-registry-manager": {
    "command": "npx",
    "args": [
      "@reuvenorg/shadcn-registry-manager"
    ],
    "env": {
      "REGISTRY_URL": "https://ui.shadcn.com/r",
      "WORKSPACE_DIR": "/Library/Projects/mcp-docker/www",
      "STYLE": "new-york"
    }
  }

Claude

Claude で MCP サーバーを使用することもできます。設定オプションは以下のとおりです。

Claude CLI コマンド：

claude mcp add --scope project shadcn-registry-manager npx @reuvenorg/shadcn-registry-manager -e REGISTRY_URL=https://ui.shadcn.com/r -e WORKSPACE_DIR=/Library/Projects/resume -e STYLE=new-york

Claude .mcp.json の設定：

{
  "shadcn-registry-manager": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "@reuvenorg/shadcn-registry-manager"
    ],
    "env": {
      "REGISTRY_URL": "https://ui.shadcn.com/r",
      "WORKSPACE_DIR": "/Library/Projects/resume",
      "STYLE": "new-york"
    }
  }
}

npx の環境変数：

• WORKSPACE_DIR - プロジェクトディレクトリへのパス（ワークスペースとしてマウントされます）
• REGISTRY_URL
  • オプション 1：https://ui.shadcn.com/r - shadcn レジストリの URL
  • オプション 2：http://localhost:3000/r - 独自のレジストリサーバーの URL（こちらのガイドに従ってください：https://ui.shadcn.com/docs/blocks）
• STYLE - shadcn レジストリのスタイルです - new-york

MCP ツールの例

• get_init_instructions：プロジェクトの初期化手順を取得
• execute_init：プロジェクトの初期化をすべて実行
• get_items：利用可能なレジストリアイテムを一覧表示
• get_item：特定のレジストリアイテムを取得
• add_item：レジストリアイテムをプロジェクトに追加
• execute_add：複数のコンポーネントをプロジェクトに追加
• get_blocks：レジストリの現在のブロックを取得

使用例

use the tool `get_blocks` to get the blocks from the registry

use the tool `add_item` - dashboard-01 to your project

ソース

• shadcn/ui
• Model Context Protocol

❤️ を込めて Reuven Naor が作成

---

MIT License。詳細は LICENSE を参照してください。