内容
oitta 网关
本 MCP 服务器为 Voitta 库提供了一个网关，允许您通过模型上下文协议（MCP）使用 Voitta 的功能。它支持 STDIO 和 SSE 传输。
## 要求
- Python 3.10+
- `requirements.txt` 中列出的依赖项（包括 voitta）
## 安装
1. 克隆此仓库
2. 安装依赖项：
```bash
pip install -r requirements.txt
```
## 配置
YAML 文件中读取 Voitta 配置。默认情况下，它查找 `/Users/gregory/g/projects/llm/roma/voitta-example/config/voitta.yaml` 文件，但您可以使用 `CONFIG_PATH` 环境变量指定其他路径应遵循 Voitta 库期望的格式。有关配置格式的详细信息，请参阅 [Voitta 文档](https://pypi.org/project/vo。
## 使用
### 在 VSCode 中运行
您可以使用提供的启动配置直接在 VSCode 中运行服务器。
### 从命令行运行
使用以下命令运行服务器：
```bash
python server.py
```
对于 HTTP 模式（SSE 传输）：
```bash
FASTMCP_HTTP=1 PORT=10000 python server.py
```
### 使用 MCP Inspector 进行测试
MCP Inspector 是测试和调试 MCP 服务器的有用工具。以下是如何使用它与 Voitta 网关：
1. 启动 MCP Inspector：
```bash
npx @modelcontextprotocol/inspector
```
2. 在 http://localhost:5173 打开检查器控制台
3. 对于 STDIO 传输（推荐用于测试），使用以下选项之一：
**选项 1：直接使用 python**
- 选择“STDIO”作为传输 - 将命令设置为：`python`（或 `python3取决于您的系统）
- 将参数设置为：`server.py`
选项：使用 uv**
- 选择“STDIO”类型
- 将命令设置为：`uv`
- 将：`run --with fastmcp --with pyyaml --with --with pydantic server.py`
**选项 3：使用cp 和完整路径**
- 选择“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/gllm/roma/mcp-gateway/server.py`）
**选项 4：使用 cd 和 fastmcp**
- 选择“STDIO”作为传输类型 - 将命令设置为：`bash`（或您的 shell）
参数设置为：`-c "cd /Users/gregory/g/projects//roma/mcp-voitta-gateway && fastmcp run"`
4. 点击“连接”以建立与服务器的连接
连接后，您可以：
“工具”选项卡下查看可用工具
- 访问 `voitta://tools` 资源以查看所有 Voitta 工具
- 通过提供输入参数并执行它们来测试工具
- 在控制台输出中查看服务器日志
对于 HTTP/SSE 传输：
1. 在 HTTP 模式下启动服务器：
```bash
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 安装
```bash
fastmcp install server.py --name "voitta-gateway"
```
### 为 Cline 安装
请遵循 Cline 文档中关于安装 MCP 服务器的说明。
