用于 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 Gateway 一起使用：

1. 启动 MCP Inspector：

   npx @modelcontextprotocol/inspector
   

2. 在 http://localhost:5173 打开 inspector 控制台

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. 连接后，您可以：

   • 在“工具”选项卡下查看可用的工具
   • 访问 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 服务器。