Yonaka15 MCP Server Runner

🚀 MCP サーバーランナー

このプロジェクトは、WebSocket サーバーを介して Model Context Protocol (MCP) サーバーを実行するための実装です。このアプリケーションにより、MCP サーバーは WebSocket 接続を通じてアクセス可能になり、Web クライアントや Web アプリケーションとの統合が促進されます。

⚠️ 重要提示

このプロジェクトは現在積極的に開発中で、WIP（未完成）状態です。機能や API は大幅に変更される可能性があります。

🚀 クイックスタート

MCP サーバーランナーを使用することで、WebSocket クライアントと MCP サーバー実装の間の橋渡しを行います。以下の手順でサーバーを起動できます。

環境変数の設定

export PROGRAM=npx
export ARGS=-y,@modelcontextprotocol/server-github
export PORT=8080
export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***

サーバーの起動

cargo run

WebSocket サーバーへの接続

const ws = new WebSocket("ws://localhost:8080");

✨ 主な機能

• 単一クライアントをサポートする WebSocket サーバー実装
• MCP サーバーインスタンスのプロセス管理
• クライアントとサーバー間の双方向メッセージング
• エレガントなシャットダウン処理
• 包括的なエラーロギング
• クロスプラットフォームサポート（Unix/Windows）

📦 インストール

前提条件

• Rust 1.70 以上
• MCP サーバー実装の実行可能ファイル

環境変数による設定

PROGRAM=        # MCP サーバー実行可能ファイルのパス（必須）
ARGS=           # MCP サーバーの引数、カンマ区切りのリスト
HOST=0.0.0.0    # バインドするホストアドレス（デフォルト：0.0.0.0）
PORT=8080       # リッスンするポート（デフォルト：8080）

その他の環境変数は MCP サーバープロセスに渡されます。

📚 ドキュメント

開発状況

• 🚧 進行中：このソフトウェアは現在積極的に開発されています。
• ⚠️ API の安定性：API と機能は予告なく変更される可能性があります。
• 🧪 テスト：現在、テストと改善が行われています。
• 📝 ドキュメント：ドキュメントは積極的に更新されています。

概要

MCP サーバーランナーは、WebSocket クライアントと MCP サーバー実装の間の橋渡し役を果たします。具体的には以下のことを行います。

• MCP サーバープロセスを起動する
• WebSocket 接続を管理する
• クライアントとサーバー間の双方向通信を処理する
• エレガントなシャットダウンとエラー処理をサポートする

アーキテクチャ

このアプリケーションはモジュール化されたアーキテクチャに従っています。

• main.rs：アプリケーションのエントリポイントとサーバー設定
• process/：プロセス管理と I/O 処理
• websocket/：WebSocket 接続管理
• state.rs：グローバル状態管理
• shutdown.rs：エレガントなシャットダウン処理

エラー処理

• MCP サーバーからの標準エラー出力は記録されますが、クライアントには転送されません。
• WebSocket 接続エラーはエレガントに処理されます。
• プロセスエラーは詳細に記録されます。

制限事項

• 単一のクライアント接続のみをサポートします。
• WebSocket SSL/TLS はサポートしていません（安全な接続にはリバースプロキシを使用してください）。
• 組み込みの認証機構はありません。

貢献方法

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを作成する

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

追加リソース

• Model Context Protocol 仕様
• WebSocket プロトコル (RFC 6455)