Zerouter

zerouter-mcp

通过 Zerouter，为 Claude、GPT、Gemini、Grok 和 Kimi 提供 AI API 网关 MCP。

zerouter-mcp 可将 Claude Desktop、Cursor、Claude Code 和其他 MCP 客户端连接到 Zerouter——一个兼容 OpenAI 的 AI API 网关。只需一个 API 密钥，你就可以与任何受支持的模型聊天、并排比较回答，或查询每 1M 个 token 的 API 定价，无需离开编辑器。

为什么选择 Zerouter

• 一个 API 密钥即可用于 Claude、GPT、Gemini、Grok 和 Kimi。 同一个 sk- 密钥可路由至所有模型。Zerouter 提供兼容 Anthropic 和兼容 OpenAI 的端点，因此可与 Claude Code、Codex 和 Cursor 配合使用——更改基础 URL 即可继续使用现有客户端。
• 在聊天中即可查询 API 定价。 Zerouter 上的 Claude Opus 5.5 每 1M 个 token 的输入价格为 $1.16，输出价格为 $5.81（Anthropic 标价为 $4 / $20）。GPT、Gemini、Grok 和 Kimi 的实时价格请见 Zerouter 定价页面。
• 确定使用前先比较模型。 将同一条提示词并行发送给 2–4 个模型，并获取各自的回答、token 用量、延迟和预估费用。
• 路由稳定，模型真实。 你发送的模型 ID 就是实际运行的模型，也是计费所用的模型。提示词不会被改写，模型也不会被替换。
• 托管闲置的订阅额度。 如果你拥有尚未用满额度的官方 AI 账号，Zerouter 提供商计划会将付费流量路由至该账号，并向你支付每个请求中较大的份额；目前约为 80%，以 USDC 结算。

功能

工具	用途	需要密钥？
get_pricing	查询 Zerouter 当前每 1M 个输入/输出 token 的 API 定价，并与各供应商的官方标价对照。可按模型或供应商筛选。	否
list_models	查看可调用的 AI 模型 ID 及其使用的端点。	否（设置密钥后使用 /v1/models）
chat	向任何模型发送提示词或消息列表，并可选设置 system、max_tokens 和 temperature。	是
compare_models	将同一条提示词并行发送给 2–4 个模型。你会收到各自的回答、token 用量、延迟和预估费用。	是

你无需操心 API 格式。chat 会为你将每个请求发送到正确的 Zerouter 端点：

• Claude 和 Kimi 使用 POST /v1/messages（Anthropic 格式）
• GPT、Codex 和 Grok 使用 POST /v1/responses（OpenAI Responses）
• Gemini 和兼容频道（Qwen/Dashscope 等）使用 POST /v1/chat/completions

如有需要，你可以通过 endpoint 参数覆盖此设置。

获取密钥

1. 登录 zerouter.ai 并打开控制面板。
2. 创建 API 密钥。密钥以 sk- 开头，可用于所有模型。
3. 按照下方配置，将密钥填入 ZEROUTER_API_KEY 环境变量。

当前 API 定价请见定价页面，设置详情请见快速入门。

设置

你需要 Node.js 18 或更高版本，以及 npm 10 或更高版本（随当前的 Node 18/20/22 版本一同捆绑）。npx 会直接从 GitHub 获取服务、构建一次并运行。首次启动时需要安装，可能耗时一分钟；之后的启动会使用 npx 缓存。

此软件包尚未发布到 npm，因此请像下方示例一样使用 github:ZerouterAI/zerouter-mcp（不要使用 zerouter-mcp）。不想使用 npx？请见其他安装方式。

Claude Desktop

编辑 claude_desktop_config.json。在 macOS 上，该文件位于 ~/Library/Application Support/Claude/；在 Windows 上，位于 %APPDATA%\Claude\：

{
  "mcpServers": {
    "zerouter": {
      "command": "npx",
      "args": ["-y", "github:ZerouterAI/zerouter-mcp"],
      "env": {
        "ZEROUTER_API_KEY": "sk-xxxx"
      }
    }
  }
}

之后重启 Claude Desktop。

Cursor

将以下内容添加到 ~/.cursor/mcp.json，使其适用于所有项目；或添加到单个项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "zerouter": {
      "command": "npx",
      "args": ["-y", "github:ZerouterAI/zerouter-mcp"],
      "env": {
        "ZEROUTER_API_KEY": "sk-xxxx"
      }
    }
  }
}

Claude Code

claude mcp add zerouter --env ZEROUTER_API_KEY=sk-xxxx -- npx -y github:ZerouterAI/zerouter-mcp

添加 --scope user，即可在每个项目中使用。

其他安装方式

MCPB bundle（Claude Desktop 一键安装）。 从最新版本下载 zerouter-mcp-0.1.0.mcpb 并打开，或将其拖入 Claude Desktop 的“设置 → 扩展”中。Claude Desktop 会提示你输入 API 密钥；无需配置 Node.js。

克隆并构建。 适用于任何能够运行本地命令的 MCP 客户端：

git clone https://github.com/ZerouterAI/zerouter-mcp.git
cd zerouter-mcp
npm install        # also builds dist/ via the prepare script

然后将客户端指向构建后的文件，并使用计算机上的绝对路径：

{
  "mcpServers": {
    "zerouter": {
      "command": "node",
      "args": ["/absolute/path/to/zerouter-mcp/dist/index.js"],
      "env": {
        "ZEROUTER_API_KEY": "sk-xxxx"
      }
    }
  }
}

对于 Claude Code：claude mcp add zerouter --env ZEROUTER_API_KEY=sk-xxxx -- node /absolute/path/to/zerouter-mcp/dist/index.js

Docker

docker build -t zerouter-mcp .
docker run -i --rm -e ZEROUTER_API_KEY=sk-xxxx zerouter-mcp

环境变量

变量	必需	默认值	备注
ZEROUTER_API_KEY	对 chat 和 compare_models 必需	无	你在 zerouter.ai 获取的密钥
ZEROUTER_BASE_URL	否	https://api.zerouter.ai	仅在通过代理路由时修改
ZEROUTER_TIMEOUT_MS	否	120000	每次请求的超时时间

如果未设置密钥，get_pricing 和 list_models 仍可使用。chat 和 compare_models 会返回明确的错误，告知你在哪里获取密钥。

提示词示例

• “Zerouter 上的 Claude Opus 5.5 与官方 API 定价相比，费用如何？”
• “让 gemini-3.8-flash 总结这个文件。”
• “针对这个正则表达式问题，比较 claude-sonnet-5-5、gpt-6-sol 和 grok-4.6，并告诉我哪个答案正确。”
• “Zerouter 上哪些模型的每百万输入令牌费用低于 $0.50？”

开发

git clone https://github.com/ZerouterAI/zerouter-mcp.git
cd zerouter-mcp
npm install       # runs the build through the prepare script
npm test          # spawns the server over stdio and calls every tool (no key needed)
npx @modelcontextprotocol/inspector node dist/index.js

链接

• 从这里开始：zerouter.ai — 获取密钥并了解其工作原理
• 模型列表：zerouter.ai/models
• API 定价：zerouter.ai/pricing
• 文档：zerouter.ai/docs
• 提供商计划：provider.zerouter.ai/docs
• 问题：github.com/ZerouterAI/zerouter-mcp/issues

许可证

MIT。由 Zerouter 团队构建。