阴影CN-松特-MCP

Name: 阴影CN-松特-MCP
Author: Michael-Obele

作者：Michael-Obele9 星标更新：2025-11-08

安装使用来源：spider==github.com

项目介绍

shadcn-svelte-mcp

基于 Mastra 的 MCP 服务器和工具，使用网络爬虫实时访问 shadcn-svelte 组件文档和开发者工具。

生产部署

选择适合您工作流程的基础主机——两者提供相同的工具集，但运行时特性不同：

主机	基础 URL	特点
Mastra Cloud	https://shadcn-svelte.mastra.cloud	首选选项 - 零冷启动，最大响应性，并且性能始终可靠。工具发现问题已修复。
Railway	https://shadcn-svelte-mcp.up.railway.app	备用选项，工具可见性一致。预期有短暂的冷启动；首次请求可能会失败然后重试成功。备用基础主机：`https://shadcn-svelte-mcp-api.up.railway.app`。

添加 /api/mcp/shadcn/sse 用于 SSE 协议（最适合保持长时间连接的编辑器）。
添加 /api/mcp/shadcn/mcp 用于 HTTP 协议（适用于 CLI 和一次性调用）。
推荐使用 Mastra Cloud 作为主要部署 - 它提供了零冷启动和最大响应性。工具发现问题已修复，可以可靠使用。当 Mastra Cloud 不可用时，Railway 可作为备份。

<details> <summary>端点参考及备选方案</summary>

Mastra Cloud SSE: https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse
Mastra Cloud HTTP: https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp
Railway SSE: https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse
Railway HTTP: https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/mcp
Railway 备用主机: 将主机替换为 https://shadcn-svelte-mcp-api.up.railway.app 并附加相同的 /api/mcp/shadcn/{sse|mcp} 路径。
如果第一次 Railway 调用返回错误，请等待一秒钟后重试——冷启动时间很短。

</details>

[!NOTE] 本项目遵循我们的行为准则，欢迎贡献！详情请参阅我们的贡献指南。

此仓库包含一个基于 Mastra 的 MCP 服务器，它通过网络爬虫实时访问 shadcn-svelte 组件文档。在您的 AI 助力代码编辑器中使用它，可以直接从官方网站获取最新的 shadcn-svelte 组件信息。

🎉 新功能

✅ 在 Mastra Cloud 上进行生产部署
✅ 四个强大的 MCP 工具用于组件发现和文档
✅ 具有拼写容错和智能建议的高级模糊搜索
✅ Lucide Svelte 图标搜索 - 浏览和搜索 1400+ 图标，具有智能过滤
✅ 支持所有主要的 AI 代码编辑器（Cursor、Windsurf、VS Code、Zed、Claude Code、Codex）
✅ HTTP 和 SSE 传输协议
✅ 实时从 shadcn-svelte.com 爬取文档

编辑器设置

推荐使用 Mastra Cloud 作为所有编辑器的主要部署，它提供了零冷启动和最大响应性。对于保持持久连接的编辑器，SSE 最佳，而 HTTP 对于一次性请求和脚本更方便。VS Code 用户可以打开命令面板（Cmd/Ctrl+Shift+P），运行 MCP: 添加服务器 并粘贴其中一个 URL。

<details> <summary>Cursor</summary>

打开 Cursor 设置（Cmd/Ctrl + ,）。
导航到 "MCP" / "模型上下文协议" 并添加一个新的服务器配置。
推荐使用 Mastra Cloud，以获得零冷启动和最大响应性。附加 SSE 或 HTTP 路径如下所示。

Mastra Cloud — SSE 示例：

{
  "shadcn-svelte": {
    "type": "sse",
    "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse"
  }
}

Mastra Cloud — HTTP 示例：

{
  "shadcn-svelte": {
    "type": "http",
    "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
  }
}

如果您希望保证工具可见性，可以换用 Railway 主机：

- "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse"
+ "url": "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse"

</details> <details> <summary>Windsurf</summary>

编辑 ~/.codeium/windsurf/mcp_config.json。
推荐使用 Mastra Cloud，以获得零冷启动和最大响应性。添加 SSE 传输如下所示：

{
  "mcpServers": {
    "shadcn-svelte": {
      "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse",
      "transport": "sse"
    }
  }
}

保存，重启 Windsurf，然后打开 mcp.json 在代理模式下点击 "开始"。

如果需要，可以使用 HTTP 变体：

{
  "servers": {
    "shadcn-svelte": {
      "type": "http",
      "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
    }
  }
}

如果您希望保证工具可见性，可以换用 Railway 主机：

- "url": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse"
+ "url": "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse"

</details> <details> <summary>Zed</summary>

打开 Zed 设置（Cmd/Ctrl + ,）。
编辑 ~/.config/zed/settings.json 并在 context_servers 下添加条目：

{
  "context_servers": {
    "shadcn-svelte": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse"
      ],
      "env": {}
    }
  }
}

如果您希望使用 Railway 端点或 HTTP 传输，可以更换主机和路径：

{
  "context_servers": {
    "shadcn-svelte": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/mcp"
      ],
      "env": {}
    }
  }
}

保存，重启 Zed，并确认代理面板中的服务器显示绿色指示器。Zed 还提供了一个无需编辑 JSON 的 UI 流程，通过设置 → 代理粘贴任一端点。

如果您希望保证工具可见性，可以换用 Railway 主机：

- "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse"
+ "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse"

</details>

CLI 和代理配置

相同的基 URL 适用于所有 CLI。推荐使用 Mastra Cloud 作为主要部署，以获得最快的响应和零冷启动。Railway 作为可靠的备用选项。

<details> <summary>Claude Code CLI (Anthropic)</summary>

全局设置 (~/.claude/settings.json)：

{
  "mcpServers": {
    "shadcn-svelte": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
      ]
    }
  }
}

项目范围覆盖 (.mcp.json)：

{
  "mcpServers": {
    "shadcn-svelte": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
      ]
    }
  }
}

启用项目服务器：

{
  "enableAllProjectMcpServers": true
}

命令面板替代方案：

claude mcp add shadcn-svelte --url https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp
claude mcp add shadcn-svelte --url https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/mcp

使用 /permissions 在 Claude Code 内部授予工具访问权限，如果提示的话。

如果您希望保证工具可见性，可以换用 Railway 主机：

- "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
+ "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/mcp"

</details> <details> <summary>OpenAI Codex CLI</summary>

注册任一端点：

codex mcp add shadcn-svelte --url https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse
codex mcp list

如果您希望保证工具可见性，可以换用 Railway 主机：

- --url https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse
+ --url https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse

</details> <details> <summary>Gemini CLI (Google)</summary>

创建或编辑 ~/.gemini/settings.json：

mkdir -p ~/.gemini
nano ~/.gemini/settings.json

添加配置。Mastra Cloud 示例：

{
  "mcpServers": {
    "shadcn-svelte": {
      "httpUrl": "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
    }
  }
}

如果您的 CLI 版本期望一个命令，偏好使用 npx mcp-remote 命令变体：

{
  "mcpServers": {
    "shadcn-svelte": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
      ]
    }
  }
}

推荐使用 Mastra Cloud，以获得零冷启动和最大响应性。重启 CLI 应用更改。Railway 作为备用选项。

如果您希望保证工具可见性，可以换用 Railway 主机：

- "https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp"
+ "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/mcp"

</details>

验证与快速测试

claude mcp list
codex mcp list
npx mcp-remote https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp
curl -I https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/mcp
curl -N https://shadcn-svelte.mastra.cloud/api/mcp/shadcn/sse

如果 Railway 检查第一次尝试失败，请稍等片刻后重试；冷启动几乎立即消失。Claude Code 可能会提示工具权限——使用 /permissions 或在 ~/.claude.json 中设置 allowedTools。保持长时间连接的编辑器应使用 SSE URL；快速脚本可以继续使用 HTTP。

备用服务器配置

<details> <summary>⚠️ 备用 URL（仅在 Mastra Cloud 不可用时使用）</summary>

Mastra Cloud (https://shadcn-svelte.mastra.cloud) 的工具发现问题已修复，现在可以可靠地作为主要部署使用。仅在 Mastra Cloud 发生停机时使用以下 Railway 主机作为备用。工具集相同，只有主机名不同。预期 Railway 部署有短暂的冷启动。

{
  "shadcn-svelte-backup": {
    "url": "https://shadcn-svelte-mcp.up.railway.app/api/mcp/shadcn/sse",
    "type": "http"
  }
}

在以下情况下使用此备用：

Mastra Cloud (https://shadcn-svelte.mastra.cloud) 发生停机。
在罕见的维护窗口期间需要回退。
您希望通过 Railway 路由流量以实现冗余。

</details>

可用工具

安装后，您的 AI 助手将拥有以下工具的访问权限：

shadcnSvelteListTool - 列出所有可用的 shadcn-svelte 组件、块、图表和文档部分
shadcnSvelteGetTool - 获取特定组件的详细文档（安装、使用、属性、示例）
shadcnSvelteUtilityTool - 访问安装指南、主题帮助、CLI 使用、迁移协助以及 Lucide Svelte 图标搜索（1400+ 图标，具有智能过滤）
shadcnSvelteSearchTool ⭐ 新功能 - 根据关键词或短语搜索组件、块、图表和文档，具有高级模糊匹配、拼写容错和智能建议

示例用法

在编辑器中安装 MCP 服务器后，您可以向您的 AI 助手询问：

"展示如何安装 shadcn-svelte 按钮组件"
"列出所有可用的 shadcn-svelte 组件"
"在 shadcn-svelte 中搜索日期选择器组件"
"查找名称中含有 'line' 的所有图表组件"
"如何自定义 shad-nc-svelte 的主题？"
"Dialog 组件的属性有哪些？"
"帮助我从 shadcn-svelte v0.x 迁移到 v1.x"
"搜索与 '用户资料' 相关的 Lucide 图标"
"查找所有箭头图标"

本地开发

想要在本地运行 MCP 服务器或为项目做出贡献？

内容

src/ - Mastra 引导程序、MCP 服务器、工具和代理
src/services/ - 用于实时文档抓取的多策略网络爬虫服务
src/mastra/tools/ - 暴露组件发现、抓取和实用工具的工具
src/mastra/agents/ - 专门用于 shadcn-svelte 辅助的 AI 代理
scripts/ - 版本管理和自动化脚本

快速开始（开发烟雾测试）

安装依赖项（使用您喜欢的包管理器）。

# npm
npm install

# 或 bun
bun install

# 或 pnpm
pnpm install

运行开发烟雾测试（推荐）：

# 在开发模式下启动 Mastra；此仓库的烟雾测试期望短时间运行以检测运行时错误
npm run dev

有用的脚本

npm run dev - 在开发模式下启动 Mastra（推荐烟雾测试）。
npm run build - 构建 Mastra 项目以供生产使用。
npm run start - 启动构建好的 Mastra 服务器。
npm run check-versions - 检查 package.json 和 mcp-server.ts 版本是否匹配（如果版本不匹配则失败）。
npm run sync-versions-auto - 检查版本并自动同步（如果版本不匹配）（package.json 是事实来源）。
npm run sync-versions - 从最新的 git 标签同步版本到两个文件。

MCP 架构

此项目公开了一个 生产就绪的 MCP 服务器，使 shadcn-svelte 文档和工具对 AI 代码编辑器可用。

这意味着：

MCP 服务器 (src/mastra/mcp-server.ts) - 向外部 MCP 客户端暴露四个 shadcn-svelte 工具（Cursor、Windsurf、VS Code 等）。
不需要 MCP 客户端 - 此项目仅提供工具，不从其他服务器消费工具。

服务器部署在 `https