Repolode
Jpisnice

Jpisnice/shadcn-ui-mcp-server

一个 MCP 服务器,让 AI 助手获取 shadcn/ui 组件的源码、示例、区块与安装信息,支持 React、Svelte、Vue 和 React Native。

Star
3,065
Fork
315
未关闭 Issue
7
最近提交
19天前

这是什么?

这是一个 Model Context Protocol(MCP)服务器,让 AI 编程助手可以查询 shadcn/ui 组件的 TypeScript 源码、示例、仪表盘和表单等区块,以及依赖和配置等元数据。助手在生成代码前能读取真实实现,而不必凭记忆猜测组件接口。

项目覆盖四个同类组件库:React 版 shadcn/ui、shadcn-svelte、shadcn-vue,以及用于 React Native 的 react-native-reusables。通过命令行参数切换框架;React 用户还可以在 Radix UI 与 Base UI 之间切换底层原语库。服务器支持 stdio 方式供 Claude Desktop、Claude Code、Cursor 等本地客户端使用,也支持无状态的 Streamable HTTP(/mcp 端点)并提供 Docker Compose 部署。GitHub API 请求带有缓存,可配置个人访问令牌以提高速率限制。

核心功能

  • 01返回 React、Svelte、Vue 和 React Native 组件的源码、示例与区块。
  • 02提供每个组件的依赖、描述和配置等元数据。
  • 03支持浏览仓库目录结构。
  • 04支持 stdio、Streamable HTTP 以及同时启用两者的传输模式。
  • 05为提示词和资源模板参数提供自动补全。
  • 06附带 Docker 与 Docker Compose 配置。

适用场景

  • 让 Claude Code 或 Cursor 基于真实组件接口生成 shadcn/ui 界面代码。
  • 对比同一组件在 React、Svelte、Vue 和 React Native 中的实现差异。
  • 为团队部署一个通过 HTTP 共享的 MCP 服务端点。

快速上手

  1. 1

    使用 npx 运行服务器(无令牌时每小时 60 次请求)

    npx @jpisnice/shadcn-ui-mcp-server
  2. 2

    使用 GitHub 令牌运行以获得更高速率限制(每小时 5000 次请求)

    npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here
  3. 3

    切换到其他框架,如 Svelte、Vue 或 React Native

    npx @jpisnice/shadcn-ui-mcp-server --framework svelte

使用前须知

  • 未提供 GitHub 令牌时,GitHub API 速率限制较低(每小时 60 次请求)。
  • Base UI 原语库选项仅支持 React。

收录于专题

标签

常见问题

shadcn-ui-mcp-server 是什么?
一个 MCP 服务器,让 AI 助手获取 shadcn/ui 组件的源码、示例、区块与安装信息,支持 React、Svelte、Vue 和 React Native。 这是一个 Model Context Protocol(MCP)服务器,让 AI 编程助手可以查询 shadcn/ui 组件的 TypeScript 源码、示例、仪表盘和表单等区块,以及依赖和配置等元数据。助手在生成代码前能读取真实实现,而不必凭记忆猜测组件接口。
shadcn-ui-mcp-server 可以免费使用吗?用的什么许可证?
shadcn-ui-mcp-server 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
shadcn-ui-mcp-server 还在维护吗?
活跃维护中。shadcn-ui-mcp-server 最近一次提交是在 2026年10月3日。
shadcn-ui-mcp-server 适合用来做什么?
让 Claude Code 或 Cursor 基于真实组件接口生成 shadcn/ui 界面代码。 对比同一组件在 React、Svelte、Vue 和 React Native 中的实现差异。 为团队部署一个通过 HTTP 共享的 MCP 服务端点。
shadcn-ui-mcp-server 怎么安装和运行?
使用 npx 运行服务器(无令牌时每小时 60 次请求): npx @jpisnice/shadcn-ui-mcp-server 使用 GitHub 令牌运行以获得更高速率限制(每小时 5000 次请求): npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here 切换到其他框架,如 Svelte、Vue 或 React Native: npx @jpisnice/shadcn-ui-mcp-server --framework svelte
在哪里获取 shadcn-ui-mcp-server?
源代码和安装说明在 GitHub 上:https://github.com/Jpisnice/shadcn-ui-mcp-server

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目