RFK Jr Gateway

🚀 用於Voitta的MCP網關服務器

此MCP服務器為Voitta庫提供網關功能，允許您通過模型上下文協議（MCP）使用Voitta的能力。它支持STDIO和SSE兩種傳輸方式，為使用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 文檔。

✨ 主要特性

• 為Voitta庫提供網關功能，支持通過MCP使用Voitta能力。
• 支持STDIO和SSE兩種傳輸方式，滿足不同場景需求。

📦 安裝指南

克隆倉庫

克隆此倉庫到本地。

安裝依賴

pip install -r requirements.txt

💻 使用示例

在VSCode中運行

可以直接從VSCode使用提供的啟動配置運行服務器。

從命令行運行

普通模式

python server.py

HTTP模式（SSE傳輸）

FASTMCP_HTTP=1 PORT=10000 python server.py

使用MCP Inspector進行測試

MCP Inspector是一個用於測試和調試MCP服務器的有用工具。以下是使用Voitta網關時的操作步驟：

啟動MCP Inspector

npx @modelcontextprotocol/inspector

打開Inspector控制檯

在瀏覽器中打開Inspector控制檯：http://localhost:5173

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（或您的shell）
• 設置參數為：-c "cd /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway && fastmcp run server.py"

建立連接

點擊“連接”以建立與服務器的連接

連接後操作

連接後，您可以：

• 在“基本信息”選項卡中查看和修改上下文
• 使用“操作”按鈕執行操作
• 查看日誌輸出

HTTP傳輸（測試時推薦）

1. 啟動MCP Inspector並導航到接口
2. 設置代理或直接連接到服務器的HTTP端點

作為客戶端運行

fastmcp run client.yaml

📚 詳細文檔

測試

基本測試

1. 啟動服務器：

python server.py

2. 使用MCP Inspector或其他工具連接到服務器並進行交互。

高級測試

• 通過配置不同的上下文和操作來測試服務器的擴展性和穩定性。
• 使用性能測試工具模擬高併發請求，評估服務器的處理能力。

注意事項

⚠️ 重要提示

• 確保安裝了所有必要的依賴項，並且 Python 版本符合要求。
• 在生產環境中使用前，請根據實際需求進行配置和優化。
• 遇到問題時，可以參考文檔或聯繫開發團隊尋求幫助。