Starwind UI MCP Server

一个用于 Starwind UI v3 和 Starwind Pro 的 TypeScript Model Context Protocol 服务器。它为 AI 客户端提供基于当前框架的、针对 Astro 和 React 项目的指导。

快速开始

关于维护的客户端设置指南，请参阅 Starwind UI MCP 文档。

Codex（~/.codex/config.toml）：

[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
enabled = true

Claude Code（.mcp.json）或 Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"]
    }
  }
}

更改配置后，请重启客户端或重新加载其 MCP 服务器。

Related MCP server: shadcn-ui MCP Server

v3 模型

Starwind UI v3 有三个相关的表层。MCP 将它们区分开来：

服务器会根据版本化的 ai-manifest.json 验证这些层，缓存验证后的数据，并在网站不可用时回退到捆绑的 v3 快照。

工具

工具调用返回可读的 JSON 文本和 MCP structuredContent。

要求与行为

• 生成的 v3 CLI 命令需要 Node.js 22.12.0 或更高版本。

• starwind_init 针对现有的 Astro 5+ 或 React 18+ 项目，除非提供了 framework，否则让 CLI 自动检测框架。

• 免费的 @starwind-pro/* 目录块在普通初始化后即可使用。付费块需要明确的授权；仅在必要时传递 pro: true。

• Starwind Pro 块目前仅适用于 Astro。React 搜索会忽略它们，React 添加请求也会明确拒绝它们。

• 迁移默认为交互式。仅在需要备份并覆盖行为时设置 yes: true。

• 包管理器和项目上下文会在可能的情况下在本地检测，添加命令会将解析后的包管理器传递给 CLI。没有工具会执行生成的命令。

从免费版升级到 Pro

MCP 保持 Pro 的可发现性，而不强制付费设置。搜索结果链接到 Pro 目录，免费的 Pro 块仍可直接安装，付费结果包含带有购买和安装链接的结构化 proUpgrade 路径。

对于现有的 Astro 项目，MCP 推荐：

pnpm dlx starwind@latest setup --yes

设置命令会自动检测项目的包管理器，因此不需要 --package-manager 标志。它会准备 Pro 注册表和 .env.local；将 STARWIND_LICENSE_KEY 占位符替换为购买的密钥，然后运行返回的 deferredCommand。将该密钥视为敏感信息：将 .env.local 排除在版本控制之外，切勿在日志或客户端代码中暴露密钥。使用 pro: true 初始化的项目将收到等效的 init --pro 命令。

开发

pnpm build
pnpm lint
pnpm test:run

运行可选的生成环境清单合约测试：

RUN_LIVE_CONTRACT_TESTS=1 pnpm test:run src/utils/starwind_live_contract.test.ts

许可证

MIT。请参阅 LICENSE。

安全性