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には3つの関連するサーフェスがあります。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 は、バックアップして上書きする動作が意図されている場合にのみ設定してください。

• パッケージマネージャーとプロジェクトのコンテキストは、可能な場合はローカルで検出され、addコマンドは解決されたパッケージマネージャーを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 を参照してください。

セキュリティ