用于Voitta的MCP网关服务器

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

系统要求

• 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. 对于 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"

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

5. 连接后，您可以：

   • 在“基本信息”选项卡中查看和修改上下文
   • 使用“操作”按钮执行操作
   • 查看日志输出

对于 HTTP 传输（测试时推荐）：

1. 启动 MCP Inspector 并导航到接口
2. 设置代理或直接连接到服务器的 HTTP 端点

作为客户端运行

使用以下命令以客户端模式运行：

fastmcp run client.yaml

测试

基本测试

1. 启动服务器：

   python server.py
   

2. 使用 MCP Inspector 或其他工具连接到服务器并进行交互。

高级测试

• 通过配置不同的上下文和操作来测试服务器的扩展性和稳定性。
• 使用性能测试工具模拟高并发请求，评估服务器的处理能力。

注意事项

• 确保安装了所有必要的依赖项，并且 Python 版本符合要求。
• 在生产环境中使用前，请根据实际需求进行配置和优化。
• 遇到问题时，可以参考文档或联系开发团队寻求帮助。