Starwind Ui MCP

🚀 星风UI MCP サーバー

TypeScript で実装された Starwind UI モデルコンテキストプロトコル (MCP) サーバーです。開発者に Starwind UI コンポーネントの処理を支援するツールを提供します。

🚀 クイックスタート

# 依存関係のインストール
pnpm install

# TypeScript コードのビルド
pnpm build

# サーバーの起動
pnpm start

IDE の設定

IDE によって、ローカル MCP サーバーの設定方法が異なります。以下は Windsurf を例にした設定です。

{
    "mcpServers": {
        "starwind ui": {
            "command": "node",
            "args": ["c:\\path\\to\\folder\\starwind-ui-mcp\\dist\\server.js"],
            "env": {}
        }
    }
}

詳細な説明は以下を参照してください。

• Windsurf MCP 設定
• Cursor MCP 設定

✨ 主な機能

• ツールベースのアーキテクチャ - モジュール化された設計で、新しいツールを簡単に追加できます。
• Starwind UI ドキュメントツール - Starwind UI コンポーネントのドキュメントリンクにアクセスできます。
• パッケージマネージャー検出 - 適切なパッケージマネージャー (npm、yarn、pnpm) を検出して使用します。
• LLM データ取得器 - starwind.dev から Starwind UI の情報を取得します（レート制限とキャッシュ付き）。
• TypeScript 実装 - TypeScript で実装されているため、より良い型安全性と開発体験が得られます。
• 標準 I/O トランスポート - stdio を使用して AI アシスタントと通信します。

📦 利用可能なツール

📚 詳細ドキュメント

開発について

このプロジェクトは、開発環境のパッケージ管理ツールとして PNPM を使用しています。pnpm を使用しない場合は、package.json ファイルを必要なパッケージマネージャーのコマンドに合わせて更新する必要があります。

プロジェクト構造

src/
  ├── config/         # サーバーの設定
  │   └── settings.ts # 設定項目
  ├── tools/          # MCP ツールの実装
  │   ├── index.ts    # ツールの登録
  │   └── *.ts        # 各ツールの個別実装
  ├── utils/          # ユーティリティ関数
  └── server.ts       # メインの MCP サーバー実装

新しいツールの追加方法

サーバーに独自のツールを追加するには、以下の手順を実行します。

1. src/tools/ ディレクトリに新しいツールファイルを作成します。
2. src/tools/index.ts でそのツールを登録します。
3. src/config/settings.ts でそのツールを有効にします。
4. pnpm build でサーバーを再構築します。
5. pnpm start でサーバーを再起動します。

🔧 技術詳細

モデルコンテキストプロトコル (MCP) は、ローカルサーバーを介して AI 機能を拡張するためのプロトコルです。この実装では、Starwind UI 用の特定のツールを提供し、AI アシスタントとの協力時の機能を強化します。MCP の詳細については、公式ドキュメント を参照してください。

📄 ライセンス

MIT ライセンスです。詳細については、LICENSE ファイルを参照してください。