Windsurf MCP Integration

🚀 风帆主控程序（MCP）サーバー

このMCPサーバーは、Windsurf IDEの機能を拡張することを目的としています。Windsurf自体に含まれていない追加ツールを提供することで、その機能を強化します。FastAPIを使用して高性能で使いやすいAPIサーバーを構築し、WebSocketをサポートすることで、WindSurfとのリアルタイム通信を実現しています。

🚀 クイックスタート

このセクションでは、MCPサーバーの基本的な使い方を説明します。

インストール

1. リポジトリをクローンします。
2. 仮想環境を作成します。

   python -m venv venv
   source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

使用方法

1. MCPサーバーを起動します。

   python main.py
   

   このコマンドでサーバーが起動し、http://localhost:8089 で待機します。

2. WindSurfをMCPサーバーに接続するように設定します。WebSocket接続アドレスを以下のように設定します。

   ws://localhost:8089/ws
   

3. APIドキュメントページにアクセスします。http://localhost:8089/docs

✨ 主な機能

• FastAPIバックエンド：高パフォーマンスで使いやすいフレームワーク
• WebSocketサポート：リアルタイムの双方向通信
• 拡張可能なツールシステム：WindSurfを拡張するために新しいツールを簡単に追加できます
• RESTful API：ツール実行用のHTTPエンドポイント
• WindSurf統合：WindSurf IDEとのシームレスな統合

📦 インストール

1. リポジトリをクローンします。
2. 仮想環境を作成します。

   python -m venv venv
   source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

# MCPサーバーの起動コマンド
python main.py

高度な使用法

# WindSurfをMCPサーバーに接続するためのWebSocket設定
ws://localhost:8089/ws

📚 ドキュメント

プロジェクト構造

MCP_servers/
├── main.py                 # 主なFastAPIアプリケーションファイル
├── tools.py                # カスタムツールの実装ファイル
├── windsurf_integration.py # WindSurf統合モジュール
├── requirements.txt        # プロジェクトの依存関係管理ファイル
└── README.md               # ドキュメント説明ファイル

組み込みツール

MCPサーバーにはいくつかの組み込みツールが付属しています。

1. ファイル検索：指定されたディレクトリ内でパターンに一致するファイルを検索します。
2. コード分析：コードファイルの構文、複雑さ、依存関係を分析します。
3. ネットワークリクエスト：外部APIにHTTPリクエストを送信します。

カスタムツールの追加

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

1. tools.py ファイルを開きます。
2. @register_tool デコレータを使用して新しいツールを登録します。

@register_tool(
    name="my_custom_tool",
    description="このツールの機能を説明します",
    parameters={
        "param1": {"type": "文字列", "description": "パラメータ1の説明"},
        "param2": {"type": "整数", "description": "パラメータ2の説明"}
    }
)
async def my_custom_tool_handler(params: Dict[str, Any]) -> Any:
    # ツールの実装コード
    param1 = params.get("param1", "")
    param2 = params.get("param2", 0)
    
    # パラメータを処理します
    result = f"処理済み {param1}，値は {param2}"
    
    return {"output": result}

APIエンドポイント

• GET /：サーバー情報を取得します。
• GET /tools：利用可能なすべてのツールをリストします。
• POST /tools/{tool_name}：指定されたツールを実行します。
• WebSocket /ws：リアルタイム通信用のWebSocketエンドポイントです。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。