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 服务器。