RFK Jr Gateway

🚀 Voitta用MCPゲートウェイサーバー

このMCPサーバーは、Voittaライブラリにゲートウェイ機能を提供し、モデルコンテキストプロトコル（MCP）を通じてVoittaの機能を利用できるようにします。STDIOとSSEの2つの伝送方式をサポートしています。

🚀 クイックスタート

このMCPサーバーを使用することで、Voittaライブラリの機能をMCP経由で利用できます。以下に、サーバーのセットアップ、実行、テストに関する詳細な手順を説明します。

✨ 主な機能

• Voittaライブラリにゲートウェイ機能を提供します。
• モデルコンテキストプロトコル（MCP）を通じてVoittaの機能を利用できます。
• STDIOとSSEの2つの伝送方式をサポートしています。

📦 インストール

システム要件

• Python 3.10以上
• requirements.txtに記載されている依存関係（voittaを含む）

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

設定

サーバーはYAMLファイルからVoittaの設定を読み取ります。デフォルトでは、/Users/gregory/g/projects/llm/roma/voitta-example/config/voitta.yaml を探しますが、CONFIG_PATH 環境変数を使用して別のパスを指定することもできます。

設定ファイルはVoittaライブラリが期待する形式に従う必要があります。詳細については、Voittaドキュメント を参照してください。

使用方法

VSCodeで実行

提供されている起動設定を使用して、VSCodeから直接サーバーを実行できます。

コマンドラインから実行

以下のコマンドを使用してサーバーを実行します。

python server.py

HTTPモード（SSE伝送）の場合は、以下のコマンドを使用します。

FASTMCP_HTTP=1 PORT=10000 python server.py

MCP Inspectorを使用したテスト

MCP Inspectorは、MCPサーバーのテストとデバッグに役立つツールです。Voittaゲートウェイを使用する場合の手順は以下の通りです。

1. MCP Inspectorを起動します。

npx @modelcontextprotocol/inspector

2. ブラウザでInspectorコンソールを開きます。http://localhost:5173

3. STDIO伝送（テスト時に推奨）の場合：

オプション1：直接pythonを使用

• 伝送タイプとして「STDIO」を選択します。
• コマンドを python（またはシステムに応じて python3）に設定します。
• パラメータを server.py に設定します。

オプション2：uvを使用

• 伝送タイプとして「STDIO」を選択します。
• コマンドを uv に設定します。
• パラメータを run --with fastmcp --with pyyaml --with voitta --with pydantic server.py に設定します。

オプション3：fastmcpと完全パスを使用

• 伝送タイプとして「STDIO」を選択します。
• コマンドを /path/to/your/fastmcp（例：/Users/gregory/g/projects/llm/roma/mcp-voitta-gateway/.venv/bin/fastmcp）に設定します。
• パラメータを run /full/path/to/server.py（例：run /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway/server.py）に設定します。

オプション4：cdとfastmcpを使用

• 伝送タイプとして「STDIO」を選択します。
• コマンドを bash（または使用しているシェル）に設定します。
• パラメータを -c "cd /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway && fastmcp run server.py" に設定します。

4. 「接続」をクリックしてサーバーとの接続を確立します。

5. 接続後、以下のことができます。

• 「基本情報」タブでコンテキストを表示および変更します。
• 「操作」ボタンを使用して操作を実行します。
• ログ出力を表示します。

HTTP伝送（テスト時に推奨）の場合：

1. MCP Inspectorを起動し、インターフェースに移動します。
2. プロキシを設定するか、サーバーのHTTPエンドポイントに直接接続します。

クライアントとして実行

以下のコマンドを使用してクライアントモードで実行します。

fastmcp run client.yaml

テスト

基本テスト

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

python server.py

2. MCP Inspectorまたは他のツールを使用してサーバーに接続し、やり取りを行います。

高度なテスト

• 異なるコンテキストと操作を設定して、サーバーの拡張性と安定性をテストします。
• パフォーマンステストツールを使用して高並行リクエストをシミュレートし、サーバーの処理能力を評価します。

🔧 注意事項

⚠️ 重要提示

• すべての必要な依存関係をインストールし、Pythonバージョンが要件を満たしていることを確認してください。
• 本番環境で使用する前に、実際のニーズに合わせて設定と最適化を行ってください。
• 問題が発生した場合は、ドキュメントを参照するか、開発チームに問い合わせてください。