MCP Voitta Gateway

🚀 Voitta 門控網關的 MCP 服務器

本 MCP 服務器為 Voitta 庫搭建了一個網關，讓您能夠藉助 Model Context Protocol (MCP) 來使用 Voitta 的各項功能。它支持 STDIO 和 SSE 兩種傳輸方式。

🚀 快速開始

✨ 主要特性

• 為 Voitta 庫提供網關，支持通過 MCP 使用其功能。
• 支持 STDIO 和 SSE 兩種傳輸方式。
• 自動註冊 Voitta 庫提供的所有工具。
• 提供 get_voitta_tool_info 工具以獲取特定 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. 選擇以下三種方式之一進行連接：
   • 選項 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（或其他 shell）。
     • 設置參數為：-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 安裝

請參考 Cline 文檔以安裝 MCP 服務器。