用途
shadcn-ui-mcp-server 是一个 Model Context Protocol（MCP）服务器，目标是让 AI 助手（LLM）获得关于 shadcn/ui 组件结构、用法和安装方式的上下文，从而把 shadcn/ui 组件集成到 AI 工作流中。它面向使用 AI 辅助开发的场景，帮助 AI 生成带有正确依赖的组件代码。
主要能力
- 多框架支持：提供 React、Svelte、Vue 和 React Native 四种 shadcn 实现的检索。
- 组件源码：获取最新的 shadcn/ui v4 TypeScript 源码。
- 组件示例：提供示例实现和用法模式。
- 区块支持：提供完整区块实现（如仪表盘、日历、表单）。
- 元数据访问：获取依赖、描述和配置详情。
- 目录浏览：可探索仓库结构。
- 智能缓存：集成 GitHub API 并处理速率限制，列表和读取结果带有协议缓存提示（ttlMs / cacheScope）。
- 参数补全：为提示词和资源模板参数提供自动补全（组件名、包管理器、构建工具等）。
- Streamable HTTP 传输：提供无状态的 /mcp 端点，用于多客户端部署（MCP 规范 2026-07-28）。
- Docker 就绪：提供可用于生产环境的容器化与 Docker Compose。
使用方式
一键安装（Claude Desktop）：从 Releases 下载 shadcn-ui-mcp-server.mcpb，双击该文件，Claude Desktop 会自动打开，输入 GitHub token（可选，用于提高速率限制），点击 Install 后工具即可用。手动安装路径为：Claude Desktop → Settings → MCP → Add Server → Browse → 选择 .mcpb 文件。
HTTP 传输与 Docker 部署：服务器实现 2026-07-28 MCP 规范（通过 MCP TypeScript SDK v2），并兼容 2025 年代的客户端。除 stdio 外，可在单个无状态 /mcp 端点提供 Streamable HTTP，用于多客户端和生产部署。传输模式包括：stdio（默认，用于 CLI）、http（在 /mcp 提供 Streamable HTTP）、dual（同时支持 stdio 和 HTTP）。旧版 SSE 传输（/sse + /message）已移除，--mode sse 仍作为 http 的已弃用别名被接受。
环境变量：MCP_TRANSPORT_MODE（传输模式 stdio|http|dual）、MCP_PORT（HTTP 端口，默认 7423）、MCP_HOST（绑定主机，默认 0.0.0.0）、MCP_CORS_ORIGINS（CORS 来源，逗号分隔）、MCP_PROTOCOL（接受的协议年代：any 为默认，含 2026-07-28 及 2025 年代回退；modern 仅 2026-07-28；CLI 参数 --protocol）、GITHUB_PERSONAL_ACCESS_TOKEN（GitHub API token）、UI_LIBRARY（UI 原语库：radix 为默认，或 base，仅 React）。
编辑器集成：提供 Autohand Code、Claude Code、VS Code、Cursor、Claude Desktop、Continue.dev 的集成说明。Autohand Code 可通过 CLI 添加该 MCP 服务器，在 shadcn 前加 --scope project 可将服务器保存到当前项目的 .autohand 配置而非用户配置。Claude Code 支持 CLI 快速添加，生产部署可使用 Streamable HTTP 传输，并针对 React、Svelte、Vue、React Native 提供框架特定命令。
从源码构建：需要 Node.js >= 20.0.0。项目包含符合 MCPB 规范的 manifest.json，.mcpb 文件是包含服务器、依赖和配置的 ZIP 归档。
适用场景
- AI 辅助开发：让 AI 助手用 shadcn/ui 构建 UI。
- 多客户端部署：无状态 HTTP 传输可水平扩展，无需粘性会话。
- 生产环境：Docker Compose 就绪，带健康检查和监控。
- 组件发现：探索可用组件及其用法。
- 多框架学习：对比 React、Svelte、Vue 和 React Native 实现。
- 快速原型：获取仪表盘、表单等完整区块实现。
- 代码生成：生成带正确依赖的组件代码。
限制
资料未提供具体的收费、价格、性能指标或效果保证。使用 GitHub API 时建议配置 GitHub token 以提高速率限制。UI_LIBRARY 的 base 选项仅适用于 React。旧版 SSE 传输已移除。
