Routara LLM Gateway

Routara MCP 服务

适用于 Routara 的官方 Model Context Protocol 服务。可在 Cursor、Claude Desktop、Codex、Windsurf、VS Code 及其他 MCP 客户端中使用 Routara 聊天、图像和视频模型。

• 网站和设置指南：https://routara.ai/mcp?utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• 兼容 OpenAI 的 API：https://api.routara.ai/v1
• 创建 API 密钥：https://routara.ai/auth?mode=register&returnTo=%2Fapp&utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• 发送首个 OpenAI SDK 请求：Python 和 Node.js 快速入门
• 在 Postman 中试用 API：可导入的首个请求集合

实用指南：Python SDK · Node.js SDK · Cursor MCP · Claude Desktop MCP

安装

npx -y routara-mcp

或者从最新的 GitHub 发布版本中一键安装 routara-mcp.mcpb 程序包。

工具

工具	描述
routara_list_models	搜索并分页浏览实时模型目录
routara_chat	单轮或多轮聊天，包括工具调用
routara_generate_image	文生图和参考图像生成
routara_generate_video	提交文生视频和图生视频任务
routara_get_video_status	轮询异步视频任务

MCP 客户端配置

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.routara]
command = "npx"
args = ["-y", "routara-mcp"]
enabled = true

[mcp_servers.routara.env]
ROUTARA_API_KEY = "sk-or-v1-YOUR_KEY_HERE"

添加配置后，重启 MCP 客户端，并让它列出 Routara 模型。然后让它使用 routara_chat 和账户可用的模型进行聊天。MCP 连接会提供工具，但不会取代宿主应用自身的模型订阅或计费方式。

环境

变量	必需	默认值
ROUTARA_API_KEY	调用工具时必需	无
ROUTARA_API_BASE	否	https://api.routara.ai/v1
ROUTARA_API_TIMEOUT_MS	否	30000

即使没有 API 密钥，进程也能启动并完成 MCP 握手。只有调用 Routara 工具时才会解析密钥，因此目录可以安全地验证此服务。

可靠性和兼容性

• 请求会超时，而不会无限期挂起。
• 对瞬时网络错误、HTTP 429 和 HTTP 5xx 响应进行有界退避重试。
• API 错误会在可用时包含上游请求 ID 和重试延迟。
• routara_chat 会返回完整的 OpenAI 兼容响应，并保留推理内容和工具调用。
• 只有显式提供媒体参数时才会转发；不同模型的支持情况各异。

开发

npm ci
npm run build
npm test
npm run validate:registry
npm run build:mcpb

执行实时 API 冒烟测试：

ROUTARA_API_KEY=sk-or-v1-... npm run test:live

目录收录

• npm
• 官方 MCP Registry
• Glama
• mcp.so
• Smithery
• PulseMCP

安全

请勿提交 API 密钥。如果密钥泄露，请立即在 Routara 控制面板中撤销。请将安全问题私下报告至 [email protected]。

许可证

MIT