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 文件。