在任意 Model Context Protocol 客户端中浏览 OrcaRouter 的模型目录并运行对话补全 —— Claude Desktop、Claude Code、Cursor、Windsurf、Zed，或任何支持该协议的客户端皆可。

目录浏览无需 API key —— 注册前即可比较定价与能力。

功能一览

• 🗺️ 无需 API key 即可发现 providers 与模型
• 💬 通过任意已上线的模型运行对话补全
• 🧠 通过工作区的 orcarouter/auto 路由器自动选模（成本 / 质量 / 均衡 / LinUCB / gated-adaptive 等策略）
• 🔁 配置回退链（主模型 + 最多 4 个 fallback）以提升可靠性
• 📊 在服务端按 provider、能力或最小上下文窗口过滤模型
• 🎯 查看详细的模型卡片：定价、上下文、延迟、支持的端点
• 🔌 适配 Claude Desktop、Claude Code、Cursor、Windsurf、Zed,以及任意 MCP 客户端

使用示例

可以这样对你的 agent 说:

• "列出 OrcaRouter 上的所有 providers"
• "展示所有 Anthropic 模型及其定价"
• "获取 minimax/minimax-m2.7 的详细信息"
• "用 orcarouter/auto 跟我聊聊量子计算"

快速开始

Claude Code（CLI 一行命令）

claude mcp add orcarouter -s user \
  -e ORCAROUTER_API_KEY=sk-orca-your-key \
  -- npx -y @orcarouter/mcp

其他客户端（配置文件方式）

1. 将对应 MCP 客户端的示例配置复制到客户端的配置文件中:

   | 客户端 | 示例 | 操作 | | --------------- | --------------------------------------------------- | ------- | | Claude Desktop | claude-desktop.json | 替换 | | Claude Code | claude-code.json | 合并 | | Cursor | cursor.json | 替换 | | Windsurf | windsurf.json | 替换 |

   配置文件路径以及 Zed 等其他客户端的说明详见 examples/README.md。

2. 将复制文件中的 sk-or-... 替换为你的 OrcaRouter API key。

3. 重启你的 MCP 客户端。

根目录的 .mcp.json 是符合 Open Plugins 标准位置的同一份配置，让扫描该文件的注册/发现工具（如 cursor.directory）能自动识别本 server。

需要 Node.js 18 或更高版本。ORCAROUTER_API_KEY 环境变量仅在使用 orcarouter_chat 时必填；目录类工具无需 API key 即可使用。

工具

• orcarouter_chat — 运行对话补全（可选配置回退链）
• orcarouter_models_list — 浏览目录（定价、上下文、能力）
• orcarouter_model_card — 单个模型的详细信息
• orcarouter_providers_list — 列出 providers 及对应模型数量

完整的输入 schema 会在运行时通过 MCP 的 tools/list 方法暴露 —— 你的 MCP 客户端（Claude Desktop、Cursor 等）会自动读取。

配置

| 名称 | 是否必填 | 说明 | | --------------------------- | -------- | ------------------------------------------------------------ | | ORCAROUTER_API_KEY | 可选 | OrcaRouter API key。仅 orcarouter_chat 需要。 | | ORCAROUTER_BASE_URL | 可选 | API base URL。默认值为 https://api.orcarouter.ai。 | | ORCAROUTER_REQUEST_TIMEOUT| 可选 | 单次请求的 HTTP 超时时间，单位为秒。默认值为 300。 |

安全

API key 仅从环境变量读取,不会被记录到日志,且只会发送给 OrcaRouter API。漏洞披露策略详见 SECURITY.md。

开发

# bun（推荐）
bun install
bun run test
bun run typecheck
bun run build

# 或使用 npm
npm install
npm test
npm run typecheck
npm run build

构建会在 dist/index.js 产出一个带 #!/usr/bin/env node shebang 的 ESM bundle, 可作为 orcarouter-mcp 二进制运行。

贡献

请参阅 CONTRIBUTING.md。新手友好的任务可以浏览 good first issue 标签。

许可证

MIT