[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"tool-Jpisnice--shadcn-ui-mcp-server":3,"similar-Jpisnice--shadcn-ui-mcp-server":134},{"id":4,"github_repo":5,"name":6,"description_en":7,"description_zh":8,"ai_summary_zh":9,"readme_en":10,"readme_zh":11,"quickstart_zh":12,"use_case_zh":13,"hero_image_url":14,"owner_login":15,"owner_name":16,"owner_avatar_url":17,"owner_bio":18,"owner_company":18,"owner_location":18,"owner_email":18,"owner_twitter":19,"owner_website":18,"owner_url":20,"languages":21,"stars":42,"forks":43,"last_commit_at":44,"license":45,"difficulty_score":46,"env_os":47,"env_gpu":48,"env_ram":48,"env_deps":49,"category_tags":55,"github_topics":60,"view_count":46,"oss_zip_url":18,"oss_zip_packed_at":18,"status":80,"created_at":81,"updated_at":82,"faqs":83,"releases":119},4979,"Jpisnice\u002Fshadcn-ui-mcp-server","shadcn-ui-mcp-server","A mcp server to allow LLMS gain context about shadcn ui component structure,usage and installation,compaitable with react,svelte 5,vue & React Native","shadcn-ui-mcp-server 是一款专为 AI 开发工作流设计的模型上下文协议（MCP）服务器，旨在让大语言模型深度理解 shadcn\u002Fui 组件库的内部结构、用法及安装细节。它有效解决了开发者在使用 AI 辅助编程时，模型因缺乏最新组件文档或具体实现代码而生成不准确代码的痛点，确保 AI 能直接输出符合 shadcn\u002Fui v4 标准的高质量代码。\n\n这款工具特别适合前端开发者、全栈工程师以及习惯使用 Claude 等 AI 助手进行快速原型开发的团队。无论是构建 React、Svelte 5、Vue 还是 React Native 应用，用户都能通过它无缝获取对应的组件源码、演示示例和完整的页面模块（Blocks）。\n\n其技术亮点在于强大的多框架支持能力，不仅涵盖主流前端框架，还允许灵活切换底层 UI 库（如从 Radix 切换至 Base UI）。此外，shadcn-ui-mcp-server 提供了智能缓存机制以优化 GitHub API 调用效率，并支持 SSE（服务器发送事件）传输模式与 Docker 容器化部署，既能满足本地命令行的高效交互，也能轻松扩展为支持","shadcn-ui-mcp-server 是一款专为 AI 开发工作流设计的模型上下文协议（MCP）服务器，旨在让大语言模型深度理解 shadcn\u002Fui 组件库的内部结构、用法及安装细节。它有效解决了开发者在使用 AI 辅助编程时，模型因缺乏最新组件文档或具体实现代码而生成不准确代码的痛点，确保 AI 能直接输出符合 shadcn\u002Fui v4 标准的高质量代码。\n\n这款工具特别适合前端开发者、全栈工程师以及习惯使用 Claude 等 AI 助手进行快速原型开发的团队。无论是构建 React、Svelte 5、Vue 还是 React Native 应用，用户都能通过它无缝获取对应的组件源码、演示示例和完整的页面模块（Blocks）。\n\n其技术亮点在于强大的多框架支持能力，不仅涵盖主流前端框架，还允许灵活切换底层 UI 库（如从 Radix 切换至 Base UI）。此外，shadcn-ui-mcp-server 提供了智能缓存机制以优化 GitHub API 调用效率，并支持 SSE（服务器发送事件）传输模式与 Docker 容器化部署，既能满足本地命令行的高效交互，也能轻松扩展为支持多客户端连接的生产级服务，是提升前端开发效率的得力助手。","# Shadcn UI v4 MCP Server\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@jpisnice%2Fshadcn-ui-mcp-server.svg)](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@jpisnice%2Fshadcn-ui-mcp-server)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n[![Trust Score](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FJpisnice_shadcn-ui-mcp-server_readme_c502b8a2c306.png)](https:\u002F\u002Farchestra.ai\u002Fmcp-catalog\u002Fjpisnice__shadcn-ui-mcp-server)\n\n> **🚀 The fastest way to integrate shadcn\u002Fui components into your AI workflow**\n\nA Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to [shadcn\u002Fui v4](https:\u002F\u002Fui.shadcn.com\u002F) components, blocks, demos, and metadata. Seamlessly retrieve React, Svelte, Vue, and React Native implementations for your AI-powered development workflow.\n\n## ✨ Key Features\n\n- **🎯 Multi-Framework Support** - React, Svelte, Vue, and React Native implementations\n- **📦 Component Source Code** - Latest shadcn\u002Fui v4 TypeScript source\n- **🎨 Component Demos** - Example implementations and usage patterns  \n- **🏗️ Blocks Support** - Complete block implementations (dashboards, calendars, forms)\n- **📋 Metadata Access** - Dependencies, descriptions, and configuration details\n- **🔍 Directory Browsing** - Explore repository structures\n- **⚡ Smart Caching** - Efficient GitHub API integration with rate limit handling\n- **🌐 SSE Transport** - Server-Sent Events support for multi-client deployments\n- **🐳 Docker Ready** - Production-ready containerization with Docker Compose\n\n## 🚀 Quick Start\n\n```bash\n# Basic usage (60 requests\u002Fhour)\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n\n# With GitHub token (5000 requests\u002Fhour) - Recommended\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key ghp_your_token_here\n\n# Switch frameworks\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework svelte\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework vue\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react-native\n\n# Use Base UI instead of Radix (React only)\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --ui-library base\n```\n\n**🎯 Get your GitHub token in 2 minutes**: [docs\u002Fgetting-started\u002Fgithub-token.md](docs\u002Fgetting-started\u002Fgithub-token.md)\n\n## 📦 One-Click Installation (Claude Desktop)\n\nDownload and double-click the `.mcpb` file for instant installation:\n\n1. Download `shadcn-ui-mcp-server.mcpb` from [Releases](https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Freleases)\n2. Double-click the file - Claude Desktop opens automatically\n3. Enter your GitHub token (optional, for higher rate limits)\n4. Click Install - tools are available immediately\n\n**Manual install:** Claude Desktop → Settings → MCP → Add Server → Browse → Select `.mcpb` file\n\n> **References:** [Anthropic Desktop Extensions](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fdesktop-extensions) | [Building MCPB](https:\u002F\u002Fsupport.claude.com\u002Fen\u002Farticles\u002F12922929-building-desktop-extensions-with-mcpb)\n\n## 🌐 SSE Transport & Docker Deployment\n\nRun the server with **Server-Sent Events (SSE)** transport for multi-client support and production deployments:\n\n### Quick Start with SSE\n```bash\n# SSE mode (supports multiple concurrent connections)\nnode build\u002Findex.js --mode sse --port 7423\n\n# Docker Compose (production ready)\ndocker-compose up -d\n\n# Connect with Claude Code\nclaude mcp add --scope user --transport sse shadcn-mcp-server http:\u002F\u002Flocalhost:7423\u002Fsse\n```\n\n### Transport Modes\n- **`stdio`** (default) - Standard input\u002Foutput for CLI usage\n- **`sse`** - Server-Sent Events for HTTP-based connections\n- **`dual`** - Both stdio and SSE simultaneously\n\n### Docker Examples\n```bash\n# Basic container\ndocker run -p 7423:7423 shadcn-ui-mcp-server\n\n# With GitHub API token\ndocker run -p 7423:7423 -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token shadcn-ui-mcp-server\n\n# Docker Compose (recommended)\ndocker-compose up -d\ncurl http:\u002F\u002Flocalhost:7423\u002Fhealth\n```\n\n### Environment Variables\n- `MCP_TRANSPORT_MODE` - Transport mode (stdio|sse|dual)\n- `MCP_PORT` - SSE server port (default: 7423 - SHADCN on keypad!)\n- `MCP_HOST` - Host binding (default: 0.0.0.0)\n- `MCP_CORS_ORIGINS` - CORS origins (comma-separated)\n- `GITHUB_PERSONAL_ACCESS_TOKEN` - GitHub API token\n- `UI_LIBRARY` - UI primitive library: `radix` (default) or `base` (React only)\n\n## 📚 Documentation\n\n| Section | Description |\n|---------|-------------|\n| [🚀 Getting Started](docs\u002Fgetting-started\u002F) | Installation, setup, and first steps |\n| [⚙️ Configuration](docs\u002Fconfiguration\u002F) | Framework selection, tokens, and options |\n| [🔌 Integration](docs\u002Fintegration\u002F) | Editor and tool integrations |\n| [📖 Usage](docs\u002Fusage\u002F) | Examples, tutorials, and use cases |\n| [🎨 Frameworks](docs\u002Fframeworks\u002F) | Framework-specific documentation |\n| [🐛 Troubleshooting](docs\u002Ftroubleshooting\u002F) | Common issues and solutions |\n| [🔧 API Reference](docs\u002Fapi\u002F) | Tool reference and technical details |\n\n## 🎨 Framework Support\n\nThis MCP server supports four popular shadcn implementations:\n\n| Framework | Repository | Maintainer | Description |\n|-----------|------------|------------|-------------|\n| **React** (default) | [shadcn\u002Fui](https:\u002F\u002Fui.shadcn.com\u002F) | [shadcn](https:\u002F\u002Fgithub.com\u002Fshadcn) | React components from shadcn\u002Fui v4 |\n| **Svelte** | [shadcn-svelte](https:\u002F\u002Fwww.shadcn-svelte.com\u002F) | [huntabyte](https:\u002F\u002Fgithub.com\u002Fhuntabyte) | Svelte components from shadcn-svelte |\n| **Vue** | [shadcn-vue](https:\u002F\u002Fwww.shadcn-vue.com\u002F) | [unovue](https:\u002F\u002Fgithub.com\u002Funovue) | Vue components from shadcn-vue |\n| **React Native** | [react-native-reusables](https:\u002F\u002Fgithub.com\u002Ffounded-labs\u002Freact-native-reusables) | [Founded Labs](https:\u002F\u002Fgithub.com\u002Ffounded-labs) | React Native components from react-native-reusables |\n\n### UI Library (React only)\n\nshadcn\u002Fui v4 supports two primitive libraries for React: **Radix UI** (default) and **Base UI**.\n\n```bash\n# Radix UI (default)\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react --ui-library radix\n\n# Base UI\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react --ui-library base\n\n# Or via environment variable\nUI_LIBRARY=base npx @jpisnice\u002Fshadcn-ui-mcp-server\n```\n\nClaude Desktop config example:\n```json\n{\n  \"args\": [\"--framework\", \"react\", \"--ui-library\", \"base\"]\n}\n```\n\n## 🛠️ Essential Setup\n\n### 1. Get GitHub Token (Recommended)\n```bash\n# Visit: https:\u002F\u002Fgithub.com\u002Fsettings\u002Ftokens\n# Generate token with no scopes needed\nexport GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here\n```\n\n### 2. Run Server\n```bash\n# React (default)\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n\n# Svelte\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework svelte\n\n# Vue  \nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework vue\n\n# React Native\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react-native\n```\n\n### 3. Integrate with Your Editor\n- **Claude Code**: See [Claude Code Integration](#-claude-code-integration) below\n- **VS Code**: [docs\u002Fintegration\u002Fvscode.md](docs\u002Fintegration\u002Fvscode.md)\n- **Cursor**: [docs\u002Fintegration\u002Fcursor.md](docs\u002Fintegration\u002Fcursor.md)\n- **Claude Desktop**: [docs\u002Fintegration\u002Fclaude-desktop.md](docs\u002Fintegration\u002Fclaude-desktop.md)\n- **Continue.dev**: [docs\u002Fintegration\u002Fcontinue.md](docs\u002Fintegration\u002Fcontinue.md)\n\n## 💻 Claude Code Integration\n\n### Quick Add (CLI)\n\n```bash\n# Add the shadcn-ui MCP server\nclaude mcp add shadcn -- bunx -y @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key YOUR_TOKEN\n```\n\n### SSE Transport\n\nFor production deployments with SSE transport:\n\n```bash\n# Start server in SSE mode\nnode build\u002Findex.js --mode sse --port 7423\n\n# Connect with Claude Code\nclaude mcp add --scope user --transport sse shadcn-mcp-server http:\u002F\u002Flocalhost:7423\u002Fsse\n```\n\n### Framework-Specific Commands\n\nSee [Claude Code Integration Guide](docs\u002Fintegration\u002Fclaude-code.md) for framework-specific commands (React, Svelte, Vue, React Native).\n\n> **Reference:** [Claude Code MCP Documentation](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmcp)\n\n## 🎯 Use Cases\n\n- **AI-Powered Development** - Let AI assistants build UIs with shadcn\u002Fui\n- **Multi-Client Deployments** - SSE transport supports multiple concurrent connections\n- **Production Environments** - Docker Compose ready with health checks and monitoring\n- **Component Discovery** - Explore available components and their usage\n- **Multi-Framework Learning** - Compare React, Svelte, Vue, and React Native implementations\n- **Rapid Prototyping** - Get complete block implementations for dashboards, forms, etc.\n- **Code Generation** - Generate component code with proper dependencies\n\n## 📦 Installation\n\n```bash\n# Global installation (optional)\nnpm install -g @jpisnice\u002Fshadcn-ui-mcp-server\n\n# Or use npx (recommended)\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n```\n\n## 🔨 Building from Source\n\n### Prerequisites\n\n- Node.js >= 18.0.0\n- npm or pnpm\n\n### Build Steps\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server.git\ncd shadcn-ui-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run the server\nnode build\u002Findex.js --github-api-key YOUR_TOKEN\n```\n\n### Run Locally\n\n```bash\n# After building, run with options\nnode build\u002Findex.js --github-api-key YOUR_TOKEN\nnode build\u002Findex.js --framework svelte\n```\n\n### Building MCPB Package\n\nThe project includes a `manifest.json` following the [MCPB specification](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fmcpb). The `.mcpb` file is a ZIP archive containing the server, dependencies, and configuration.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed packaging instructions.\n\n> **Reference:** [Building Desktop Extensions with MCPB](https:\u002F\u002Fsupport.claude.com\u002Fen\u002Farticles\u002F12922929-building-desktop-extensions-with-mcpb)\n\n## 🔗 Quick Links\n\n- 📖 [Full Documentation](docs\u002F)\n- 🚀 [Getting Started Guide](docs\u002Fgetting-started\u002F)\n- 🌐 [SSE Transport & Docker Guide](SSE_IMPLEMENTATION.md)\n- 🎨 [Framework Comparison](docs\u002Fframeworks\u002F)\n- 🔧 [API Reference](docs\u002Fapi\u002F)\n- 🐛 [Troubleshooting](docs\u002Ftroubleshooting\u002F)\n- 💬 [Issues & Discussions](https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server)\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## 🙏 Acknowledgments\n\n- **[shadcn](https:\u002F\u002Fgithub.com\u002Fshadcn)** - For the amazing React UI component library\n- **[huntabyte](https:\u002F\u002Fgithub.com\u002Fhuntabyte)** - For the excellent Svelte implementation\n- **[unovue](https:\u002F\u002Fgithub.com\u002Funovue)** - For the comprehensive Vue implementation\n- **[Founded Labs](https:\u002F\u002Fgithub.com\u002Ffounded-labs)** - For the React Native implementation\n- **[Anthropic](https:\u002F\u002Fanthropic.com)** - For the Model Context Protocol specification\n\n---\n\n**Made with ❤️ by [Janardhan Polle](https:\u002F\u002Fgithub.com\u002FJpisnice)**\n\n**Star ⭐ this repo if you find it helpful!**\n","# Shadcn UI v4 MCP 服务器\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@jpisnice%2Fshadcn-ui-mcp-server.svg)](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@jpisnice%2Fshadcn-ui-mcp-server)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n[![Trust Score](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FJpisnice_shadcn-ui-mcp-server_readme_c502b8a2c306.png)](https:\u002F\u002Farchestra.ai\u002Fmcp-catalog\u002Fjpisnice__shadcn-ui-mcp-server)\n\n> **🚀 将 shadcn\u002Fui 组件无缝集成到您的 AI 工作流中的最快方式**\n\n这是一款模型上下文协议 (MCP) 服务器，为 AI 助手提供对 [shadcn\u002Fui v4](https:\u002F\u002Fui.shadcn.com\u002F) 组件、区块、示例和元数据的全面访问。您可以轻松获取 React、Svelte、Vue 和 React Native 的实现，以支持您的 AI 驱动开发工作流。\n\n## ✨ 核心特性\n\n- **🎯 多框架支持** - 支持 React、Svelte、Vue 和 React Native 实现\n- **📦 组件源码** - 最新 shadcn\u002Fui v4 TypeScript 源代码\n- **🎨 组件示例** - 示例实现及使用模式  \n- **🏗️ 区块支持** - 完整区块实现（仪表板、日历、表单等）\n- **📋 元数据访问** - 依赖项、描述及配置详情\n- **🔍 目录浏览** - 探索仓库结构\n- **⚡ 智能缓存** - 高效的 GitHub API 集成，并处理速率限制\n- **🌐 SSE 传输** - 支持 Server-Sent Events，适用于多客户端部署\n- **🐳 Docker 就绪** - 使用 Docker Compose 的生产就绪容器化方案\n\n## 🚀 快速入门\n\n```bash\n# 基本用法（每小时 60 次请求）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n\n# 使用 GitHub Token（每小时 5000 次请求）- 推荐\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key ghp_your_token_here\n\n# 切换框架\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework svelte\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework vue\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react-native\n\n# 使用 Base UI 替代 Radix UI（仅限 React）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --ui-library base\n```\n\n**🎯 2 分钟内获取 GitHub Token**：[docs\u002Fgetting-started\u002Fgithub-token.md](docs\u002Fgetting-started\u002Fgithub-token.md)\n\n## 📦 一键安装（Claude Desktop）\n\n下载并双击 `.mcpb` 文件即可立即安装：\n\n1. 从 [Releases](https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Freleases) 下载 `shadcn-ui-mcp-server.mcpb`\n2. 双击文件 - Claude Desktop 会自动打开\n3. 输入您的 GitHub Token（可选，用于提高请求限额）\n4. 点击“安装” - 工具将立即可用\n\n**手动安装**：Claude Desktop → 设置 → MCP → 添加服务器 → 浏览 → 选择 `.mcpb` 文件\n\n> **参考文献**：[Anthropic Desktop 扩展](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fdesktop-extensions) | [构建 MCPB](https:\u002F\u002Fsupport.claude.com\u002Fen\u002Farticles\u002F12922929-building-desktop-extensions-with-mcpb)\n\n## 🌐 SSE 传输与 Docker 部署\n\n使用 **Server-Sent Events (SSE)** 传输运行服务器，以支持多客户端连接和生产环境部署：\n\n### SSE 模式快速启动\n```bash\n# SSE 模式（支持多个并发连接）\nnode build\u002Findex.js --mode sse --port 7423\n\n# Docker Compose（生产就绪）\ndocker-compose up -d\n\n# 使用 Claude Code 连接\nclaude mcp add --scope user --transport sse shadcn-mcp-server http:\u002F\u002Flocalhost:7423\u002Fsse\n```\n\n### 传输模式\n- **`stdio`**（默认）- 用于 CLI 使用的标准输入输出\n- **`sse`** - 基于 HTTP 的 Server-Sent Events 连接\n- **`dual`** - 同时支持 stdio 和 SSE\n\n### Docker 示例\n```bash\n# 基础容器\ndocker run -p 7423:7423 shadcn-ui-mcp-server\n\n# 带 GitHub API Token\ndocker run -p 7423:7423 -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token shadcn-ui-mcp-server\n\n# Docker Compose（推荐）\ndocker-compose up -d\ncurl http:\u002F\u002Flocalhost:7423\u002Fhealth\n```\n\n### 环境变量\n- `MCP_TRANSPORT_MODE` - 传输模式（stdio|sse|dual）\n- `MCP_PORT` - SSE 服务器端口（默认：7423 - SHADCN 在键盘上！）\n- `MCP_HOST` - 主机绑定（默认：0.0.0.0）\n- `MCP_CORS_ORIGINS` - CORS 来源（逗号分隔）\n- `GITHUB_PERSONAL_ACCESS_TOKEN` - GitHub API Token\n- `UI_LIBRARY` - UI 基础库：`radix`（默认）或 `base`（仅限 React）\n\n## 📚 文档\n\n| 版块 | 描述 |\n|------|------|\n| [🚀 入门指南](docs\u002Fgetting-started\u002F) | 安装、设置及第一步 |\n| [⚙️ 配置](docs\u002Fconfiguration\u002F) | 框架选择、Token 及选项 |\n| [🔌 集成](docs\u002Fintegration\u002F) | 编辑器及工具集成 |\n| [📖 使用](docs\u002Fusage\u002F) | 示例、教程及用例 |\n| [🎨 框架](docs\u002Fframeworks\u002F) | 各框架专用文档 |\n| [🐛 故障排除](docs\u002Ftroubleshooting\u002F) | 常见问题及解决方案 |\n| [🔧 API 参考](docs\u002Fapi\u002F) | 工具参考及技术细节 |\n\n## 🎨 框架支持\n\n该 MCP 服务器支持四种流行的 shadcn 实现：\n\n| 框架 | 仓库 | 维护者 | 描述 |\n|------|------|--------|------|\n| **React**（默认） | [shadcn\u002Fui](https:\u002F\u002Fui.shadcn.com\u002F) | [shadcn](https:\u002F\u002Fgithub.com\u002Fshadcn) | shadcn\u002Fui v4 的 React 组件 |\n| **Svelte** | [shadcn-svelte](https:\u002F\u002Fwww.shadcn-svelte.com\u002F) | [huntabyte](https:\u002F\u002Fgithub.com\u002Fhuntabyte) | shadcn-svelte 的 Svelte 组件 |\n| **Vue** | [shadcn-vue](https:\u002F\u002Fwww.shadcn-vue.com\u002F) | [unovue](https:\u002F\u002Fgithub.com\u002Funovue) | shadcn-vue 的 Vue 组件 |\n| **React Native** | [react-native-reusables](https:\u002F\u002Fgithub.com\u002Ffounded-labs\u002Freact-native-reusables) | [Founded Labs](https:\u002F\u002Fgithub.com\u002Ffounded-labs) | react-native-reusables 的 React Native 组件 |\n\n### UI 库（仅限 React）\n\nshadcn\u002Fui v4 支持两种 React 基础库：**Radix UI**（默认）和 **Base UI**。\n\n```bash\n# Radix UI（默认）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react --ui-library radix\n\n# Base UI\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react --ui-library base\n\n# 或通过环境变量\nUI_LIBRARY=base npx @jpisnice\u002Fshadcn-ui-mcp-server\n```\n\nClaude Desktop 配置示例：\n```json\n{\n  \"args\": [\"--framework\", \"react\", \"--ui-library\", \"base\"]\n}\n```\n\n## 🛠️ 必备设置\n\n### 1. 获取 GitHub Token（推荐）\n```bash\n# 访问：https:\u002F\u002Fgithub.com\u002Fsettings\u002Ftokens\n# 生成无需任何权限范围的 Token\nexport GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here\n```\n\n### 2. 运行服务器\n```bash\n# React（默认）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n\n# Svelte\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework svelte\n\n# Vue  \nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework vue\n\n# React Native\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react-native\n```\n\n### 3. 与您的编辑器集成\n- **Claude Code**: 请参阅下方的[Claude Code 集成](#-claude-code-integration)\n- **VS Code**: [docs\u002Fintegration\u002Fvscode.md](docs\u002Fintegration\u002Fvscode.md)\n- **Cursor**: [docs\u002Fintegration\u002Fcursor.md](docs\u002Fintegration\u002Fcursor.md)\n- **Claude Desktop**: [docs\u002Fintegration\u002Fclaude-desktop.md](docs\u002Fintegration\u002Fclaude-desktop.md)\n- **Continue.dev**: [docs\u002Fintegration\u002Fcontinue.md](docs\u002Fintegration\u002Fcontinue.md)\n\n## 💻 Claude Code 集成\n\n### 快速添加（CLI）\n\n```bash\n# 添加 shadcn-ui MCP 服务器\nclaude mcp add shadcn -- bunx -y @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key YOUR_TOKEN\n```\n\n### SSE 传输\n\n对于使用 SSE 传输的生产部署：\n\n```bash\n# 以 SSE 模式启动服务器\nnode build\u002Findex.js --mode sse --port 7423\n\n# 使用 Claude Code 连接\nclaude mcp add --scope user --transport sse shadcn-mcp-server http:\u002F\u002Flocalhost:7423\u002Fsse\n```\n\n### 框架特定命令\n\n有关框架特定命令（React、Svelte、Vue、React Native），请参阅[Claude Code 集成指南](docs\u002Fintegration\u002Fclaude-code.md)。\n\n> **参考：** [Claude Code MCP 文档](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmcp)\n\n## 🎯 使用场景\n\n- **AI 驱动开发** - 让 AI 助手使用 shadcn\u002Fui 构建 UI\n- **多客户端部署** - SSE 传输支持多个并发连接\n- **生产环境** - 已准备好 Docker Compose，带有健康检查和监控\n- **组件发现** - 探索可用组件及其用法\n- **多框架学习** - 比较 React、Svelte、Vue 和 React Native 的实现\n- **快速原型设计** - 获取仪表板、表单等的完整区块实现\n- **代码生成** - 生成包含正确依赖项的组件代码\n\n## 📦 安装\n\n```bash\n# 全局安装（可选）\nnpm install -g @jpisnice\u002Fshadcn-ui-mcp-server\n\n# 或者使用 npx（推荐）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n```\n\n## 🔨 从源码构建\n\n### 先决条件\n\n- Node.js >= 18.0.0\n- npm 或 pnpm\n\n### 构建步骤\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server.git\ncd shadcn-ui-mcp-server\n\n# 安装依赖\nnpm install\n\n# 构建项目\nnpm run build\n\n# 运行服务器\nnode build\u002Findex.js --github-api-key YOUR_TOKEN\n```\n\n### 本地运行\n\n```bash\n# 构建后，可带选项运行\nnode build\u002Findex.js --github-api-key YOUR_TOKEN\nnode build\u002Findex.js --framework svelte\n```\n\n### 构建 MCPB 包\n\n该项目包含一个遵循[MCPB 规范](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fmcpb)的 `manifest.json` 文件。`.mcpb` 文件是一个 ZIP 存档，包含服务器、依赖项和配置。\n\n有关详细的打包说明，请参阅[CONTRIBUTING.md](CONTRIBUTING.md)。\n\n> **参考：** [使用 MCPB 构建桌面扩展](https:\u002F\u002Fsupport.claude.com\u002Fen\u002Farticles\u002F12922929-building-desktop-extensions-with-mcpb)\n\n## 🔗 快速链接\n\n- 📖 [完整文档](docs\u002F)\n- 🚀 [入门指南](docs\u002Fgetting-started\u002F)\n- 🌐 [SSE 传输与 Docker 指南](SSE_IMPLEMENTATION.md)\n- 🎨 [框架比较](docs\u002Fframeworks\u002F)\n- 🔧 [API 参考](docs\u002Fapi\u002F)\n- 🐛 [故障排除](docs\u002Ftroubleshooting\u002F)\n- 💬 [问题与讨论](https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server)\n\n## 📄 许可证\n\nMIT 许可证 - 详情请参阅[LICENSE](LICENSE)。\n\n## 🙏 致谢\n\n- **[shadcn](https:\u002F\u002Fgithub.com\u002Fshadcn)** - 感谢其出色的 React UI 组件库\n- **[huntabyte](https:\u002F\u002Fgithub.com\u002Fhuntabyte)** - 感谢其优秀的 Svelte 实现\n- **[unovue](https:\u002F\u002Fgithub.com\u002Funovue)** - 感谢其全面的 Vue 实现\n- **[Founded Labs](https:\u002F\u002Fgithub.com\u002Ffounded-labs)** - 感谢其 React Native 实现\n- **[Anthropic](https:\u002F\u002Fanthropic.com)** - 感谢其 Model Context Protocol 规范\n\n---\n\n**由 [Janardhan Polle](https:\u002F\u002Fgithub.com\u002FJpisnice) 用心制作**\n\n**如果您觉得本项目有帮助，请为它点亮星星 ⭐！**","# shadcn-ui-mcp-server 快速上手指南\n\n`shadcn-ui-mcp-server` 是一个基于模型上下文协议（MCP）的服务器工具，旨在让 AI 助手（如 Claude、Cursor 等）能够直接访问和使用 **shadcn\u002Fui v4** 的组件、代码块和元数据。它支持 React、Svelte、Vue 和 React Native 多种框架，是构建 AI 驱动前端工作流的高效工具。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **Node.js**: 版本 >= 18.0.0\n*   **包管理器**: `npm` 或 `pnpm`\n*   **GitHub Token (推荐)**: \n    *   虽然不强制，但配置 GitHub Personal Access Token 可将 API 请求限制从每小时 60 次提升至 5000 次。\n    *   获取方式：访问 [GitHub Tokens 设置页](https:\u002F\u002Fgithub.com\u002Fsettings\u002Ftokens)，生成一个无需特定权限（no scopes needed）的 Token。\n\n## 安装步骤\n\n您可以选择全局安装或直接使用 `npx` 运行（推荐）。\n\n### 方式一：直接使用 npx（推荐）\n\n无需预先安装，直接在终端运行即可：\n\n```bash\n# 基础运行（限流 60 次\u002F小时）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server\n\n# 推荐：携带 GitHub Token 运行（限流 5000 次\u002F小时）\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key ghp_your_token_here\n```\n\n### 方式二：全局安装\n\n如果您希望将命令添加到全局路径：\n\n```bash\nnpm install -g @jpisnice\u002Fshadcn-ui-mcp-server\n```\n\n安装后，可直接运行 `shadcn-ui-mcp-server` 命令。\n\n### 切换框架\n\n该工具默认支持 React，也可通过参数切换至其他框架：\n\n```bash\n# Svelte\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework svelte\n\n# Vue\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework vue\n\n# React Native\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --framework react-native\n\n# React 使用 Base UI 代替默认的 Radix UI\nnpx @jpisnice\u002Fshadcn-ui-mcp-server --ui-library base\n```\n\n## 基本使用\n\n安装完成后，您需要将服务器集成到您的 AI 编辑器或 IDE 中。以下是两种最常用的集成方式。\n\n### 1. 集成到 Claude Code (CLI)\n\n如果您使用 Claude Code 命令行工具，可以使用以下命令快速添加服务：\n\n```bash\n# 添加 shadcn-ui MCP 服务器（请替换 YOUR_TOKEN 为您的实际 Token）\nclaude mcp add shadcn -- bunx -y @jpisnice\u002Fshadcn-ui-mcp-server --github-api-key YOUR_TOKEN\n```\n\n添加成功后，您可以在对话中直接要求 AI 生成 shadcn\u002Fui 组件代码。\n\n### 2. 集成到 Claude Desktop (图形界面)\n\n对于桌面版用户，可以通过一键安装包快速配置：\n\n1.  从 [Releases 页面](https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Freleases) 下载 `shadcn-ui-mcp-server.mcpb` 文件。\n2.  双击该文件，Claude Desktop 将自动打开。\n3.  在弹出的窗口中输入您的 GitHub Token（可选，但推荐）。\n4.  点击 **Install**，工具即刻可用。\n\n**手动安装路径**：Claude Desktop → Settings → MCP → Add Server → Browse → 选择下载的 `.mcpb` 文件。\n\n### 3. 高级用法：SSE 模式与 Docker\n\n适用于生产环境或多客户端并发场景：\n\n```bash\n# 启动 SSE 模式服务器\nnode build\u002Findex.js --mode sse --port 7423\n\n# 使用 Docker Compose 启动（需项目根目录有 docker-compose.yml）\ndocker-compose up -d\n\n# 在 Claude Code 中连接 SSE 服务\nclaude mcp add --scope user --transport sse shadcn-mcp-server http:\u002F\u002Flocalhost:7423\u002Fsse\n```\n\n现在，您可以在 AI 对话中尝试输入：“帮我用 shadcn\u002Fui 创建一个带有深色模式的登录表单”，AI 将利用该服务器获取最新的组件源码并生成代码。","前端开发者小李正使用 Claude 辅助构建一个基于 Next.js 和 shadcn\u002Fui v4 的复杂数据仪表盘，需要快速集成日历、表单及图表模块。\n\n### 没有 shadcn-ui-mcp-server 时\n- **版本幻觉严重**：AI 常混淆 shadcn\u002Fui v3 与 v4 的 API 差异，生成的代码因组件属性变更（如 `Calendar` 组件的重构）而无法运行。\n- **手动复制繁琐**：开发者需频繁切换浏览器查找官方文档，手动复制组件源码和依赖配置，打断编码心流。\n- **框架适配困难**：当项目需从 React 迁移至 Svelte 5 或 Vue 时，AI 缺乏对应框架的实现细节，只能提供错误的 React 代码。\n- **区块组装低效**：构建完整的“登录页”或“仪表板”区块时，AI 无法一次性获取所有子组件的正确组合方式，导致多次试错。\n\n### 使用 shadcn-ui-mcp-server 后\n- **精准上下文感知**：shadcn-ui-mcp-server 直接为 AI 注入 v4 最新 TypeScript 源码和元数据，确保生成的代码属性准确、即拷即用。\n- **工作流无缝衔接**：在 IDE 内通过自然语言指令即可获取组件安装命令、依赖列表及完整示例，无需离开编辑器查阅文档。\n- **多框架智能切换**：只需启动时指定 `--framework svelte` 或 `vue` 参数，AI 即刻输出对应框架的最佳实践代码，消除跨框架障碍。\n- **区块一键生成**：利用其对 Blocks 的支持，AI 能直接输出包含布局、样式和逻辑的完整仪表盘区块，大幅缩短组装时间。\n\nshadcn-ui-mcp-server 通过将官方组件库转化为 AI 可理解的实时上下文，彻底消除了大模型在前端 UI 开发中的“知识滞后”与“幻觉”痛点。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FJpisnice_shadcn-ui-mcp-server_aa641e4b.png","Jpisnice","Janardhan Polle","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FJpisnice_fd07dbc6.png",null,"sataklela05","https:\u002F\u002Fgithub.com\u002FJpisnice",[22,26,30,34,38],{"name":23,"color":24,"percentage":25},"TypeScript","#3178c6",94,{"name":27,"color":28,"percentage":29},"PowerShell","#012456",3.3,{"name":31,"color":32,"percentage":33},"Shell","#89e051",1.8,{"name":35,"color":36,"percentage":37},"JavaScript","#f1e05a",0.6,{"name":39,"color":40,"percentage":41},"Dockerfile","#384d54",0.3,2744,284,"2026-04-06T22:40:33","MIT",2,"Linux, macOS, Windows","未说明",{"notes":50,"python":51,"dependencies":52},"该工具是基于 Node.js 的 MCP 服务器，无需 Python 环境。建议配置 GitHub Personal Access Token 以提高 API 请求限额（从每小时 60 次提升至 5000 次）。支持通过 Docker 部署及 SSE 传输模式以适配多客户端生产环境。","不需要",[53,54],"Node.js >= 18.0.0","npm 或 pnpm",[56,57,58,59],"音频","Agent","开发框架","图像",[61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79],"ai","mcp","modelcontextprotocol","ts","typescript","shadcn-ui","ui","webdev","nextjs","npm","npm-package","npx","react","svelte","sveltekit","vue","vuejs","expo","react-native","ready","2026-03-27T02:49:30.150509","2026-04-11T18:33:33.259996",[84,89,94,99,104,109,114],{"id":85,"question_zh":86,"answer_zh":87,"source_url":88},22616,"遇到 'Unexpected token G, \"GitHub API\"... is not valid JSON' 错误怎么办？","该问题已修复。请确保更新到最新版本的 npm 包。此外，建议配置 GitHub Access Token 以确保服务器正常工作并避免速率限制问题。如果问题仍然存在，请尝试重新安装或检查日志。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F6",{"id":90,"question_zh":91,"answer_zh":92,"source_url":93},22617,"如何在 Cursor IDE 中正确配置 GitHub API Key？","在配置文件中，`--github-api-key` 参数后应跟随两个值：首先是您为 Token 起的名称（例如 'SHADCN'），然后是实际的 Token 字符串。配置示例如下：\n```json\n{\n  \"mcpServers\": {\n    \"shadcn-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"@jpisnice\u002Fshadcn-ui-mcp-server\", \"SHADCN\", \"ghp_your_token_here\"]\n    }\n  }\n}\n```\n请确保参考最新的文档和故障排除指南。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F11",{"id":95,"question_zh":96,"answer_zh":97,"source_url":98},22618,"是否支持 Vue 项目集成？","是的，Vue 集成已经添加。您可以使用 shadcn-vue 版本。维护者已合并相关 PR 并建议在 README 中查看具体的 Vue 安装步骤。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F22",{"id":100,"question_zh":101,"answer_zh":102,"source_url":103},22619,"调用 get_block 时出现 'Failed to list blocks: Unexpected response from GitHub API' 错误如何解决？","维护者已发布新版本修复了此问题。请尝试更新 `@jpisnice\u002Fshadcn-ui-mcp-server` 到最新版本并重启服务器。如果问题依旧，请检查您的 GitHub Token 权限是否正确。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F28",{"id":105,"question_zh":106,"answer_zh":107,"source_url":108},22620,"MCP 服务器启动失败或显示 'Failed to start client' 怎么办？","首先请确保已发布并安装了最新版本的 npm 包。检查您的配置文件（特别是 GitHub Token 的有效性）。如果问题持续，可能需要清理环境并进行全新安装。维护者通常会通过发布新版本来修复此类启动问题。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F13",{"id":110,"question_zh":111,"answer_zh":112,"source_url":113},22621,"为什么在 Svelte 项目中仍然返回 React 组件？","这是一个已知问题，已在后续更新中修复。请参考最新文档以获取针对 Svelte 项目的正确配置方法。确保您的 MCP 服务器配置中包含了正确的 Svelte 参数，并更新至最新版本。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F20",{"id":115,"question_zh":116,"answer_zh":117,"source_url":118},22622,"MCP 服务器完全无法工作且没有具体报错信息怎么办？","这通常是由于版本过旧导致的。维护者会定期发布修复补丁到 npm 仓库。请运行更新命令获取最新版本，并验证错误是否仍然存在。同时确认您的 GitHub Personal Access Token 格式正确且具有必要的权限。","https:\u002F\u002Fgithub.com\u002FJpisnice\u002Fshadcn-ui-mcp-server\u002Fissues\u002F21",[120,125,129],{"id":121,"version":122,"summary_zh":123,"released_at":124},136330,"v2.0.0","MCPB 功能及其他错误修复","2026-01-30T14:47:32",{"id":126,"version":127,"summary_zh":18,"released_at":128},136331,"v1.1.4","2025-10-23T08:16:02",{"id":130,"version":131,"summary_zh":132,"released_at":133},136332,"v1.0.1","MCP服务器首次发布","2025-06-11T15:08:04",[135,145,153,162,170,179],{"id":136,"name":137,"github_repo":138,"description_zh":139,"stars":140,"difficulty_score":141,"last_commit_at":142,"category_tags":143,"status":80},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[57,58,59,144],"数据工具",{"id":146,"name":147,"github_repo":148,"description_zh":149,"stars":150,"difficulty_score":141,"last_commit_at":151,"category_tags":152,"status":80},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[58,59,57],{"id":154,"name":155,"github_repo":156,"description_zh":157,"stars":158,"difficulty_score":46,"last_commit_at":159,"category_tags":160,"status":80},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",150037,"2026-04-10T23:33:47",[58,57,161],"语言模型",{"id":163,"name":164,"github_repo":165,"description_zh":166,"stars":167,"difficulty_score":46,"last_commit_at":168,"category_tags":169,"status":80},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[58,59,57],{"id":171,"name":172,"github_repo":173,"description_zh":174,"stars":175,"difficulty_score":46,"last_commit_at":176,"category_tags":177,"status":80},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[178,57,59,58],"插件",{"id":180,"name":181,"github_repo":182,"description_zh":183,"stars":184,"difficulty_score":46,"last_commit_at":185,"category_tags":186,"status":80},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[178,58]]