内容
# Routara MCP 服务器
[](https://www.npmjs.com/package/routara-mcp)
[](https://registry.modelcontextprotocol.io/v0/servers/io.github.36412749-collab/routara-mcp)
[](https://glama.ai/mcp/servers/36412749-collab/routara-mcp)
[](LICENSE)
**Routara** 的官方 [模型上下文协议](https://modelcontextprotocol.io) 服务器 — 通过 `api.routara.ai` 调用 **787+ LLMs**、图像和视频模型，支持 **Cursor**、**Claude Desktop**、**Windsurf**、**VS Code** 等 MCP 客户端。
- **网站：** https://routara.ai
- **API：** https://api.routara.ai/v1
- **获取 API 密钥：** https://routara.ai/#auth （注册赠送 1 美元促销积分）
## 安装
```bash
npx -y routara-mcp
```
或全局安装：`npm install -g routara-mcp`
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `routara_list_models` | 列出 Routara 目录中的模型 |
| `routara_chat` | 聊天完成（兼容 OpenAI） |
| `routara_generate_image` | 图像生成（需要现金钱包余额） |
| `routara_generate_video` | 提交异步视频任务（需要现金余额） |
| `routara_get_video_status` | 查询视频任务状态 |
## 快速开始
1. 在 [routara.ai → 认证](https://routara.ai/#auth) 处创建 API 密钥（`sk-or-v1-...`）。
2. 添加到您的 MCP 客户端：
### Cursor
设置 → MCP → 添加服务器，或编辑 `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"routara": {
"command": "npx",
"args": ["-y", "routara-mcp"],
"env": {
"ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
}
}
}
}
```
### Claude Desktop
`%APPDATA%\Claude\claude_desktop_config.json` （Windows）或 `~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）：
```json
{
"mcpServers": {
"routara": {
"command": "npx",
"args": ["-y", "routara-mcp"],
"env": {
"ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
}
}
}
}
```
## 环境变量
| 变量 | 是否必需 | 默认值 |
|----------|----------|---------|
| `ROUTARA_API_KEY` | 是 | — |
| `ROUTARA_API_BASE` | 否 | `https://api.routara.ai/v1` |
## 已列出
- [npm](https://www.npmjs.com/package/routara-mcp) · `routara-mcp@1.0.2`
- [官方 MCP 注册表](https://registry.modelcontextprotocol.io/v0/servers/io.github.36412749-collab/routara-mcp) · `io.github.36412749-collab/routara-mcp`
- [Glama](https://glama.ai/mcp/servers/36412749-collab/routara-mcp) · 已声明列表
- [mcp.so](https://mcp.so/server/routara-llm-gateway/36412749-collab)
- [Smithery](https://smithery.ai/server/nbjack9897/routara-mcp)
- [PulseMCP](https://www.pulsemcp.com/servers?q=routara)
## 健康检查（Glama / CI）
服务器在没有 `ROUTARA_API_KEY` 的情况下启动，因此注册表可以运行 MCP 握手（`initialize` + `tools/list`）。调用工具时需要 API 密钥。
```bash
npm ci && npm run build && npm test
# 可选的实时探测（需要真实密钥）：
ROUTARA_API_KEY=sk-or-v1-... npm run test:live
```
在推送到 GitHub 后，请重新运行 **认领所有权** 以刷新列表索引。
## 故障排除
| 症状 | 解决方法 |
|---------|-----|
| 调用工具时提示 `ROUTARA_API_KEY is required` | 在 MCP 客户端配置中设置环境变量； 在 [routara.ai/#auth](https://routara.ai/#auth) 获取密钥 |
| `401 invalid_api_key` | 在仪表盘中重新生成密钥； 确保 `sk-or-v1-` 前缀 |
| `402` / 余额不足 | 在 routara.ai 充值现金钱包 |
| 图像/视频失败，聊天正常 | 媒体需要 **现金** 余额； 促销积分仅限于经济模型聊天 |
| 检查器中服务器无法启动 | 使用 `npx -y routara-mcp`， Node 版本 ≥18； 如果从源代码开发，请运行 `npm run build` |
## 开发
```bash
npm install
npm run build
ROUTARA_API_KEY=sk-or-v1-... npm run test:live
npm test
```
## 计费说明
- 一个 API 密钥适用于文本、图像和视频 — 切换 `model` 和工具，而不是密钥。
- 图像/视频需要 **现金钱包** 余额（促销积分不能用于媒体）。
- 聊天使用标准的每令牌计费，具备 Smart Route™ 跨上游池的故障转移功能。
## 相关
- **JSON 翻译 GitHub Action：** https://github.com/36412749-collab/json-translate-action
- **文档：** https://routara.ai/docs
## 许可证
MIT © [Routara](https://routara.ai)
