Shadcn Registry Mcp Server

shadcn registry manager - MCP 服务

本项目为 shadcn/ui 组件注册表和 CLI 提供 MCP（Model Context Protocol）服务。它支持远程、以编程方式或在容器中执行 shadcn CLI 命令（例如 init、add 等），这些命令通常需要在本地运行，因此可轻松实现自动化、集成，或在云端/开发环境中运行。该 MCP 服务可连接本地和远程 shadcn 注册表，为通过 AI 或 CLI Agent 自动执行项目管理任务提供安全、可扩展且技术化的接口。

功能

此 MCP 服务将 shadcn CLI 操作作为 MCP 工具公开，因此你（或 AI Agent）可以：

• 初始化项目
• 添加 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

你也可以使用 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

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。