MCP Server Research

🚀 MCP サーバー研究プロジェクト

このプロジェクトは、MCP（メッセージコーディネーションプロトコル）サーバーの実装に関する研究とデモを含んでいます。MCPは分散システム間の通信と調整を標準化する手段を提供し、本リポジトリにはその参考実装と実例が含まれています。

🚀 クイックスタート

このセクションでは、MCPサーバー研究プロジェクトの基本的なセットアップと実行方法を説明します。

前提条件

• Python 3.8+
• Flask
• Requests

インストール

# リポジトリをクローンする
git clone https://github.com/ckz/mcp_server_research.git
cd mcp_server_research

# 仮想環境を設定する
python -m venv venv
source venv/bin/activate  # Windowsシステムの場合は：venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

実行例

デフォルト設定でMCPサーバーを起動するには、以下のコマンドを実行します。

cd src/demo
python simple_mcp_server.py

環境変数を使用してカスタム設定で起動するには、以下のコマンドを実行します。

cd src/demo
DEBUG=true PORT=5001 python simple_mcp_server.py

その後、http://localhost:5001（または指定したカスタムポート）にアクセスしてダッシュボードを確認します。

別のターミナルでクライアントの例を実行するには、以下のコマンドを実行します。

cd src/demo
python client_demo.py --server http://localhost:5001 --duration 30 --interval 2

サーバーが接続を受け入れ、クライアントがメッセージを正常に送信するのを確認できます。

✨ 主な機能

シンプルなMCPサーバーのデモでは、以下の基本機能が実装されています。

• 接続されたクライアントの登録と追跡
• さまざまなメッセージタイプ（ハートビート、データ、コマンド）の処理
• メッセージを適切な宛先にルーティング
• システムのアクティビティを監視するためのWebダッシュボードの提供
• メモリ内のメッセージ履歴の維持

📦 インストール

このセクションでは、MCPサーバー研究プロジェクトのインストール手順を説明します。

前提条件

• Python 3.8+
• Flask
• Requests

インストール手順

# リポジトリをクローンする
git clone https://github.com/ckz/mcp_server_research.git
cd mcp_server_research

# 仮想環境を設定する
python -m venv venv
source venv/bin/activate  # Windowsシステムの場合は：venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

💻 使用例

基本的な使用法

# デフォルト設定でMCPサーバーを起動する
cd src/demo
python simple_mcp_server.py

高度な使用法

# 環境変数を使用してカスタム設定でMCPサーバーを起動する
cd src/demo
DEBUG=true PORT=5001 python simple_mcp_server.py

その後、http://localhost:5001（または指定したカスタムポート）にアクセスしてダッシュボードを確認します。

# 別のターミナルでクライアントの例を実行する
cd src/demo
python client_demo.py --server http://localhost:5001 --duration 30 --interval 2

サーバーが接続を受け入れ、クライアントがメッセージを正常に送信するのを確認できます。

📚 ドキュメント

プロジェクト構造

mcp_server_research/
├── docs/          # ドキュメントファイル
├── src/           # ソースコード
│   └── demo/      # サンプル実装
└── requirements.txt

変更履歴

2024-02-24

• クライアントコードにエラーハンドリングを追加して接続失敗を防ぐ
• クライアントでセッションを使用してより良い接続管理を実現
• サーバー側にCORSサポートを追加してクロスドメインリクエストを処理
• API呼び出しのタイムアウトを実装して長時間のハングを防ぐ
• 環境変数を使用してデバッグモードを設定可能にする
• 依存関係の問題を解決し、flask-corsを追加してwerkzeugのバージョンを指定
• コードコメントのドキュメントを改善

📄 ライセンス

MIT

貢献

貢献を歓迎します！自由にプルリクエストを送信してください。