使用说明
Voitta的MCP网关
此MCP服务器提供了一个通往Voitta库的网关，允许您通过模型上下文协议（MCP）使用Voitta的功能。它支持STDIO和SSE传输。
需求
- Python 3.10+
- 中列出的依赖关系
requirements.txt（包括胜利）
安装
- 克隆此存储库
- 安装依赖项：
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网关一起使用：
-
启动MCP检查器：
npx @modelcontextprotocol/inspector -
打开检查器控制台http://localhost:5173
-
对于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"
-
点击“连接”以建立与服务器的连接
-
连接后，您可以：
- 在“工具”选项卡下查看可用工具
- 访问
voitta://tools查看所有Voitta工具的资源 - 通过提供输入参数并执行这些参数来测试工具
- 在控制台输出中查看服务器日志
对于HTTP/SSE传输：
- 以HTTP模式启动服务器：
FASTMCP_HTTP=1 PORT=10000 python server.py - 在MCP检查器中，选择“SSE”作为传输类型
- 将URL设置为：
http://localhost:10000 - 点击“连接”
可用工具和资源
服务器会自动注册Voitta库提供的所有工具。您可以使用以下工具获取可用工具的列表 voitta://tools 资源。
此外，服务器还提供以下MCP工具：
get_voitta_tool_info：获取有关特定Voitta工具的详细信息，包括其参数和描述。
LLM助理的安装
为Claude安装
fastmcp install server.py --name "voitta-gateway"
为Cline安装
按照Cline文档安装MCP服务器。
