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 版本符合要求。
• 在生产环境中使用前，请根据实际需求进行配置和优化。
• 遇到问题时，可以参考文档或联系开发团队寻求帮助。