MCP Server for Windsurf

Windsurf 用 MCP サーバー

Windsurf のエージェント型 IDE に追加ツールを提供する Master Control Program（MCP）サーバーです。

概要

この MCP サーバーは、Windsurf に組み込まれていない追加ツールを提供し、Windsurf の機能を拡張するために設計されています。FastAPI を使用して、Windsurf とリアルタイムに通信するための WebSocket サポートを備えた堅牢な API サーバーを構築します。

機能

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

プロジェクト構成

MCP_servers/
├── main.py                 # Main FastAPI application
├── tools.py                # Custom tool implementations
├── windsurf_integration.py # Windsurf integration module
├── requirements.txt        # Project dependencies
└── README.md               # Documentation

組み込みツール

MCP サーバーには、いくつかの組み込みツールが含まれています。

1. ファイル検索：パターンマッチングを使ってディレクトリ内のファイルを検索します
2. コード分析：コードファイルの構文、複雑さ、依存関係を分析します
3. Web リクエスト：外部 API に HTTP リクエストを送信します

インストール

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

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

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

   pip install -r requirements.txt
   

使用方法

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

   python main.py
   

   これにより、http://localhost:8089 でサーバーが起動します

2. WebSocket 接続を次のように設定して、Windsurf を MCP サーバーに接続します：

   ws://localhost:8089/ws
   

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

カスタムツールの追加

MCP サーバーに新しいツールを追加するには：

1. tools.py を開きます
2. @register_tool デコレーターを使ってツールを登録します：

@register_tool(
    name="my_custom_tool",
    description="Description of what the tool does",
    parameters={
        "param1": {"type": "string", "description": "Description of parameter 1"},
        "param2": {"type": "integer", "description": "Description of parameter 2"}
    }
)
async def my_custom_tool_handler(params: Dict[str, Any]) -> Any:
    # Tool implementation
    param1 = params.get("param1", "")
    param2 = params.get("param2", 0)
    
    # Do something with the parameters
    result = f"Processed {param1} with value {param2}"
    
    return {"output": result}

API エンドポイント

• GET /：サーバー情報
• GET /tools：利用可能なすべてのツールを一覧表示
• POST /tools/{tool_name}：指定したツールを実行
• WebSocket /ws：リアルタイム通信のための WebSocket エンドポイント

ライセンス

MIT