Shadcn Registry MCP

MCP开发工具

提供方 Rachidhssin

开发工具 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursorWindsurf

一个安全MCP服务器,为AI编码助手提供直接访问shadcn/ui组件注册表的能力,实现组件的自动获取、安装和配置

一句话选型结论

按资料字段整理

Shadcn Registry MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI编程助手TypeScript本地部署组件管理前端开发安全协议自动化工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Shadcn Registry MCP当前 8 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Rachidhssin上游标注的维护方 Rachidhssin
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.3 KB
来自项目仓库与上游目录的原文,未做删改

shadcn-registry-mcp

你的AI不需要终端。

shadcn-registry-mcp 是一个安全的MCP服务器,它允许AI编码助手(Claude、Cursor、Windsurf等)直接访问shadcn/ui注册表,无需进行任何上下文切换即可获取、安装和连接组件。


它做什么

你与你的AI对话。你的AI与此服务器对话。服务器处理其他所有事务。

没有终端。没有损坏的deps。没有复制粘贴。


为什么存在

人工智能生成的UI往往是通用的。 当你的AI猜测组件结构而不是从实际的注册表中读取时,你会得到不一致的代码,这会与你的设计系统产生冲突。

公共MCP注册表存在安全风险。 MCP生态系统是供应链攻击的积极目标,恶意服务器伪装成开发人员工具,以窃取SSH密钥、令牌和环境变量。

此服务器解决了以下两个问题:

  • 准确安装 --组件直接来自官方 ui.shadcn.com 注册表,具有精确的文件结构、依赖树和shadcn想要的CSS变量。没有猜测。
  • 会话流 --要求提供数据表、侧边栏或整个表单工具包。服务器解析可传递的deps,写入所有文件,并运行包管理器。你留在谈话中。
  • 代码库安全 --服务器读取您的 components.json 在编写单个文件之前,了解您的确切项目布局。它与你的结构融为一体,而不是与之对立。
  • 加强安保 --网络出口已锁定到 ui.shadcn.com 只有。路径遍历被阻止。软件包安装使用 execFile(),永远不要连接shell。你的环境始终属于你。

这是给谁的

前端和全栈开发人员使用shadcn/ui,希望他们的AI助手能够正确安装组件,具有完全的依赖关系解析、正确的文件放置和零安全隐患。

如果你曾经有过人工智能告诉你“跑步” npx shadcn@latest add button“谈话中,这是给你的。


快速开始

先决条件

  • Node.js 18+ ·检查一下 node --version
  • shadcn/ui项目 ·奔跑 npx shadcn@latest init 如果尚未设置

步骤1——添加到您的AI客户端

🖥️ Claude Desktop

打开配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json

添加 shadcn 进入下 mcpServers:```json
{
"mcpServers": {
"shadcn": {
"command": "npx",
"args": ["-y", "shadcn-registry-mcp"]
}
}
}


**退出并重新启动** 保存后的克劳德桌面。

💻  Claude Code

**仅适用于当前项目:**```bash
claude mcp add shadcn -- npx -y shadcn-registry-mcp

对于所有项目(推荐):```bash
claude mcp add shadcn --scope global -- npx -y shadcn-registry-mcp


确认已连接:```bash
claude mcp list
# shadcn   npx -y shadcn-registry-mcp   connected ✓

> 如果状态显示 failed,npx可能有一个过时的缓存。修复: claude mcp remove shadcn 然后重新添加 npx -y shadcn-registry-mcp@latest.

🖱️ Cursor

编辑 .cursor/mcp.json 在项目根目录中(如果不存在,则创建它):```json
{
"mcpServers": {
"shadcn": {
"command": "npx",
"args": ["-y", "shadcn-registry-mcp"]
}
}
}


保存后重新启动Cursor。

🌊  Windsurf

编辑 `~/.codeium/windsurf/mcp_config.json`:```json
{
"mcpServers": {
"shadcn": {
"command": "npx",
"args": ["-y", "shadcn-registry-mcp"]
}
}
}

保存后重新启动Windsurf。

📦 One-click install (.mcpb)

下载 shadcn-registry-mcp.mcpb 从 最新版本 打开它——没有终端,没有配置编辑。与任何支持 .mcpb 格式。


第二步——验证它是否正常工作

问你的AI:

> “列出我安装的shadcn组件”

MCP服务器将直接响应。如果AI运行 npx shadcn@latest 在终端中,服务器没有连接——请参阅下面的故障排除。


故障排除

failed to connect 在 claude mcp list
npx在安装包之前缓存了一个“找不到”的结果。修复:```bash
claude mcp remove shadcn
claude mcp add shadcn --scope global -- npx -y shadcn-registry-mcp@latest


**`components.json not found`**
服务器需要一个shadcn初始化项目。跑 `npx shadcn@latest init` 首先在你的项目根目录中。

**AI使用终端而不是MCP**
明确: *“使用 `add_component` 安装工具\[名称\]“*。如果提示不明确,某些代理默认使用CLI。

**重新启动Claude Code后服务器消失**
您在项目范围内添加了它。重新添加 `--scope global` 使其持久。

______________________________________________________________________

## 工具

您的AI助手可以使用八种工具:

|工具|它做什么|写|
|---|---|:---:|
| `detect_project` |框架、包管理器、组件目录、shadcn配置|--|
| `list_components` |所有可用组件,可按类别筛选|--|
| `list_groups` |批量安装的预定义组|--|
| `search_components` |按名称或关键字查找,按相关性排序|--|
| `get_component_info` |项目中的文件、deps、CSS变量、安装状态|--|
| `add_component` |安装具有完整dep分辨率的组件或组;支持 `dryRun` | ✓ |
| `remove_component` |清理卸载--删除组件文件|✓ |
| `list_installed` |你的项目中已经包含了什么|--|
```ts
// Preview before writing anything
add_component({ names: ["sidebar", "button"], dryRun: true })

// Install an entire group at once
add_component({ group: "form" })  // input, textarea, select, checkbox, label, form…

组: form · layout · navigation · overlay · data · feedback · typography


安全

MCP生态系统存在供应链问题。恶意服务器伪装成开发人员工具,窃取凭据、SSH密钥和环境机密。此服务器在构建时考虑了该威胁模型:

控制 它阻止了什么
网络出口已锁定 ui.shadcn.com 注册表数据或工具输入无法触发对攻击者控制域的请求
路径遍历预防 注册表提供的路径已根据项目根进行验证和解析,否 ../../.ssh 逃跑
无外壳注射 execFile() 具有类型化的args数组;注册表中的包名称无法注入shell命令
无stdout污染 所有日志记录都转到 stderr;stdio JSON-RPC通道从未损坏
最小文件系统范围 只读 components.json, package.json,及其引用的目录
Zod输入验证 在任何代码运行之前,每个工具输入都经过模式验证

兼容性

适用于 Next.js (应用+页面路由器), 维特,以及简单的React。
自动检测 npm, pnpm, 纱线,以及 小圆面包 从你的锁文件中。

客户端 状态
克劳德桌面 ✅
克劳德代码 ✅
光标 ✅
风浪 ✅
任何兼容MCP的客户端 ✅

自定义注册表

通过以下方式指向内部设计系统 components.json:```json
{ "registryUrl": "https://registry.company.com/r" }


或者通过env-var(在CI中很有用):```json
{ "env": { "SHADCN_REGISTRY_URL": "https://registry.company.com/r" } }

首先检查自定义注册表;官方的shadcn注册表是回退,内部和标准组件并行工作。


建筑```

src/
├── index.ts Entry point — stdio transport, process lifecycle
├── server.ts McpServer — all 8 tools registered with Zod schemas
├── types.ts Typed interfaces + error classes (SecurityError, CircularDepError…)
│
├── tools/ Thin handlers — validate input, compose modules, format output
│ ├── add-component.ts Installs by name list or group · "did you mean?" on typos
│ ├── remove-component.ts Uninstalls by name · path-validated deletion
│ ├── detect-project.ts
│ ├── get-component-info.ts
│ ├── list-components.ts
│ ├── list-installed.ts
│ └── search-components.ts
│
├── registry/
│ ├── client.ts HTTPS-only fetch · host whitelist · 5-min cache · 2× retry
│ ├── resolver.ts Recursive dep tree · cycle detection · Levenshtein suggestions
│ └── groups.ts 7 predefined groups
│
├── project/
│ ├── analyzer.ts Walks up to components.json · framework + pkg manager detection
│ └── scanner.ts Checks installed components by scanning configured directories
│
└── writer/
├── file-writer.ts Path-validated writes · dry-run support
├── file-remover.ts Path-validated deletion
├── css-writer.ts Idempotent CSS variable merging
└── pkg-installer.ts execFile-based installs · per-package fallback

tests/
├── registry/client.test.ts Fetch, caching, security, custom registry
├── project/analyzer.test.ts Framework + pkg manager detection
├── writer/file-writer.test.ts Path validation and write logic
├── writer/file-remover.test.ts Path traversal security + deletion
└── e2e/
├── add-component.test.ts Full pipeline: dry-run, install, skip, transitive deps
├── remove-component.test.ts Delete, no-op, partial, multi-component
└── detect-project.test.ts Framework detection, alias resolution, missing config


______________________________________________________________________

## 发展```bash
git clone https://github.com/Rachidhssin/shadcn-registry-mcp
npm install

npm run dev          # Run with tsx — no build step needed
npm run build        # Compile TypeScript → dist/
npm test             # Run 42 tests (unit + E2E)
npm run test:watch   # Watch mode
npm run pack:bundle  # Build + create shadcn-registry-mcp.mcpb bundle

贡献

我们欢迎并感谢您的贡献。以下是如何参与其中:

  1. 标记回购 --如果这能节省你的时间,一颗星星会帮助别人找到它,并让项目继续进行。
  2. 报告问题 --发现错误或组件安装不正确? 打开一个问题.
  3. 提交PR --叉子→ 分支→ 编写测试→ 打开一个PR。两者都有 npm test 和 npm run build 必须干净利落地通过。
  4. 建议功能 --对新工具或集成有想法吗?在问题选项卡中开始讨论。

> 安全说明: 所有安全属性(网络出口锁定、路径验证、外壳安全)都必须在每个PR中保留。新的网络目标、文件系统路径或外壳调用需要在PR描述中明确说明理由。


如果这个项目对你有帮助,考虑给它一个⭐ 这意味着很多。

麻省理工学院·与 MCP TypeScript SDK ·由 shadcn/ui注册表

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Shadcn Registry MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Shadcn Registry MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Shadcn Registry MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Shadcn Registry MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Shadcn Registry MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Shadcn Registry MCP 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 AI编程助手、安全协议、TypeScript、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。