MCP Gateway for RFK Jr Endpoints

Voitta的MCP网关

此MCP服务器提供了一个通往Voitta库的网关，允许您通过模型上下文协议（MCP）使用Voitta的功能。它支持STDIO和SSE传输。

需求

• Python 3.10+
• 中列出的依赖关系 requirements.txt （包括胜利）

安装

1. 克隆此存储库
2. 安装依赖项：

   pip install -r requirements.txt

配置

服务器从YAML文件读取Voitta配置。默认情况下，它会在以下位置查找文件 /Users/gregory/g/projects/llm/roma/voitta-example/config/voitta.yaml，但您可以使用指定其他路径 CONFIG_PATH 环境变量。

配置文件应遵循Voitta库所期望的格式。请参阅 赢得文档 有关配置格式的详细信息。

用法

使用VSCode运行

您可以使用提供的启动配置直接从VSCode运行服务器。

从命令行运行

使用以下命令运行服务器：

python server.py

对于HTTP模式（SSE传输）：

FASTMCP_HTTP=1 PORT=10000 python server.py

MCP检验员测试

MCP检查器是测试和调试MCP服务器的有用工具。以下是如何将其与Voitta网关一起使用：

1. 启动MCP检查器：

   npx @modelcontextprotocol/inspector

1. 打开检查器控制台http://localhost:5173

1. 对于STDIO传输（建议用于测试），请使用以下选项之一：

选项1：直接使用python

- 选择“STDIO”作为传输类型 - 将命令设置为： python （或 python3 取决于您的系统） - 将参数设置为： server.py

选项2：使用紫外线

- 选择“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"

1. 点击“连接”以建立与服务器的连接

1. 连接后，您可以：

- 在“工具”选项卡下查看可用工具 - 访问 voitta://tools 查看所有Voitta工具的资源 - 通过提供输入参数并执行这些参数来测试工具 - 在控制台输出中查看服务器日志

对于HTTP/SSE传输：

1. 以HTTP模式启动服务器：

   FASTMCP_HTTP=1 PORT=10000 python server.py

1. 在MCP检查器中，选择“SSE”作为传输类型
2. 将URL设置为： http://localhost:10000
3. 点击“连接”

可用工具和资源

服务器会自动注册Voitta库提供的所有工具。您可以使用以下工具获取可用工具的列表 voitta://tools 资源。

此外，服务器还提供以下MCP工具：

• get_voitta_tool_info：获取有关特定Voitta工具的详细信息，包括其参数和描述。

LLM助理的安装

为Claude安装

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

为Cline安装

按照Cline文档安装MCP服务器。