Starwind UI MCP Server

io.github.starwind-ui由 GitHub 帳號 starwind-ui 發布v0.5.1更新於 Oct 24, 2026

Framework-aware Starwind UI v3 tools for Astro and React setup, components, docs, and migration.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

Starwind UI 的 MCP 伺服器，為 AI 助理提供 Astro 與 React 專案的 Starwind UI v3 元件、原語、文件與遷移指引。

可以做什麼
  • 依框架中繼資料與篩選條件搜尋樣式元件、原語與 Pro 區塊
  • 為 Astro 或 React 專案產生初始化與元件安裝指令
  • 解析特定元件、原語、Runtime、遷移與框架文件
  • 檢查專案並提供以互動為優先的 v2 到 v3 遷移建議
  • 每次工具呼叫同時回傳可讀 JSON 與結構化內容
適用情境
在使用 Starwind UI v3 建置或維護 Astro、React 專案時，希望助理查詢最新元件、文件以及初始化或遷移指令，而不是自行猜測。也適合規劃 v2 到 v3 的升級。
執行需求
以 stdio 在本機執行，通常透過 npm 套件 @starwind-ui/mcp 以 npx 啟動；未宣告驗證或環境變數。產生的 v3 CLI 指令需要 Node.js 22.12.0 以上版本，初始化對象為既有的 Astro 5+ 或 React 18+ 專案。付費 Pro 區塊需要已購買的授權金鑰並寫入 .env.local。
安裝前請注意
伺服器只產生指令而不執行，執行前請自行檢查。遷移預設為互動式，設定 yes: true 會啟用備份並覆寫的行為。付費 Pro 區塊需要明確授權並購買；STARWIND_LICENSE_KEY 屬敏感資訊，不應進入版本控制、日誌或前端程式碼。Pro 區塊目前僅支援 Astro。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Starwind UI MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[Starwind UI MCP Server]

[npm] [GitHub stars]

Official MCP Registry · io.github.starwind-ui/mcp

A TypeScript Model Context Protocol server for Starwind UI v3 and Starwind Pro. It gives AI clients current, framework-aware guidance for Astro and React projects.

Quick start

For the maintained client setup guide, see the Starwind UI MCP documentation.

Codex (~/.codex/config.toml):

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

Claude Code (.mcp.json) or Cursor (.cursor/mcp.json):

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

Restart the client or reload its MCP servers after changing the configuration.

v3 model

Starwind UI v3 has three related surfaces. The MCP keeps them distinct:

SurfaceWhat it representsMCP behavior
Styled componentsCopy-owned UI components with Astro and/or React implementationsSearch and install with starwind_search and starwind_add
PrimitivesLower-level Astro and React adapters, backed by Starwind Runtime where applicableSearch with surface: "primitive"; install with the v3 primitives add command
RuntimeFramework-neutral behavior APIsFetch with starwind_docs using the Runtime topic or surface

The server validates these layers against the versioned ai-manifest.json, caches validated data, and falls back to a bundled v3 snapshot if the site is unavailable.

Tools

ToolPurpose
starwind_initGenerate v3 initialization commands for an existing Astro or React project. Pro is opt-in.
starwind_addValidate requests and generate installation or deferred-install commands for styled components, primitives, or Astro-only Pro blocks.
starwind_searchSearch styled components, primitives, and Pro blocks with framework metadata and filters.
starwind_docsResolve exact component, primitive, Runtime, migration, and framework documentation.
starwind_migrateInspect a project and generate safe, interactive-first v2-to-v3 migration guidance.

Tool calls return both readable JSON text and MCP structuredContent.

Requirements and behavior

  • Generated v3 CLI commands require Node.js 22.12.0 or newer.
  • starwind_init targets existing Astro 5+ or React 18+ projects and lets the CLI auto-detect the framework unless framework is supplied.
  • Free @starwind-pro/* catalog blocks work after ordinary initialization. Paid blocks require explicit authorization; pass pro: true only when it is required.
  • Starwind Pro blocks currently target Astro. React searches omit them, and React add requests reject them explicitly.
  • Migration is interactive by default. Set yes: true only when backup-and-overwrite behavior is intended.
  • Package-manager and project context are detected locally when possible, and add commands pass the resolved package manager to the CLI. No tool executes the generated command.

Upgrading from free to Pro

The MCP keeps Pro discoverable without forcing paid setup. Search results link to the Pro catalog, free Pro blocks remain directly installable, and paid results include a structured proUpgrade path with purchase and installation links.

For an existing Astro project, the MCP recommends:

bash
pnpm dlx starwind@latest setup --yes

The setup command auto-detects the project's package manager, so it does not need a --package-manager flag. It prepares the Pro registry and .env.local; replace the STARWIND_LICENSE_KEY placeholder with the purchased key, then run the returned deferredCommand. Treat the key as sensitive: keep .env.local out of source control and never expose the key in logs or client-side code. A project initialized with pro: true receives the equivalent init --pro command instead.

Development

bash
pnpm buildpnpm lintpnpm test:run

Run the opt-in production manifest contract test with:

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

License

MIT. See LICENSE.

Security

[MseeP.ai Security Assessment Badge]

來源：README.md，提交 01986a9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.5.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分