MCP Voitta Gateway

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

この MCP サーバーは、Voitta ライブラリにゲートウェイを提供し、Model Context Protocol (MCP) を通じて Voitta の機能を使用できるようにします。STDIO と SSE の 2 つの伝送方式をサポートしています。

🚀 クイックスタート

この MCP サーバーを使用することで、Voitta ライブラリの機能を MCP を通じて利用できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• Voitta ライブラリにゲートウェイを提供し、MCP を通じて機能を利用可能にする。
• STDIO と SSE の 2 つの伝送方式をサポートする。
• サーバーは Voitta ライブラリが提供するすべてのツールを自動的に登録する。

📦 インストール

前提条件

• 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. 以下の 4 つの接続方法から 1 つを選択します。
   • オプション 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. 接続が成功したら、以下のことができます。
   • 「ツール」タブで利用可能なすべてのツールを表示します。
   • voitta://tools リソースにアクセスして、すべての Voitta ツールを表示します。
   • 入力パラメータを提供して実行することで、ツールをテストします。
   • コンソール出力でサーバーのログを表示します。

HTTP/SSE 伝送の場合は、以下の手順を実行します。

1. 以下のコマンドを使用して、サーバーの HTTP モードを起動します。

FASTMCP_HTTP=1 PORT=10000 python server.py

2. MCP Inspector で伝送タイプとして「SSE」を選択します。
3. URL を http://localhost:10000 に設定します。
4. 「接続」をクリックします。

利用可能なツールとリソース

サーバーは Voitta ライブラリが提供するすべてのツールを自動的に登録します。voitta://tools リソースを通じて利用可能なツールのリストを取得できます。

また、サーバーは以下の MCP ツールも提供します。

• get_voitta_tool_info：特定の Voitta ツールの詳細情報（パラメータや説明を含む）を取得します。

LLM アシスタント用のインストール

Claude 用のインストール

fastmcp install server.py --name "voitta-gateway"

Cline 用のインストール

MCP サーバーをインストールするには、Cline ドキュメントを参照してください。