Shadcn Registry Manager

🚀 shadcn註冊表管理器 - MCP服務器

本項目為 shadcn/ui 組件註冊表和 CLI 提供了一個 MCP（模型上下文協議）服務器。它允許遠程、程序化或容器化執行通常在本地運行的 shadcn CLI 命令（如 init、add 等），便於在雲環境或開發環境中自動化、集成或運行這些命令。MCP 服務器可以連接到本地和遠程的 shadcn 註冊表，通過人工智能或 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 掛載說明：

• - 是你項目目錄的路徑。 示例：/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

你也可以使用 npx 運行 MCP 服務器，這對於本地開發或 CI/CD 管道很方便。在 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

你還可以將 MCP 服務器與 Claude 一起使用。以下是配置選項：

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

💻 使用示例

基礎用法

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

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

可用工具示例

• get_init_instructions：獲取項目初始化說明
• execute_init：運行完整的項目初始化
• get_items：列出可用的註冊表項
• get_item：獲取特定的註冊表項
• add_item：向你的項目添加註冊表項
• execute_add：向你的項目添加多個組件
• get_blocks：從註冊表獲取當前塊

📚 詳細文檔

項目來源

• shadcn/ui
• 模型上下文協議

本項目由 Reuven Naor 用心打造。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。