Crazyrouter Mcp Server

Crazyrouter MCP：聊天、图像生成和模型发现

实用指南 / 实操入口

• 产品文案＋配图、模型发现＋保存图片 / 可运行工作流
• 版本与验证边界 / 验证

更新于 2026-10-12。此 MCP 服务使用你的 API 密钥，将受支持的客户端连接到 Crazyrouter。本仓库实现了三个工具；网关的完整目录包含的内容更多。

工具

工具	API	范围
chat	POST /v1/chat/completions	面向 Chat Completions 模型的文本消息；默认使用 gpt-4o-mini
list_models	GET /v1/models 加上公开端点元数据	你的密钥可用的实时模型；可选类别筛选
generate_image	POST /v1/images/generations	生成一张同步图像；默认使用 gpt-image-2；尺寸因模型而异

发现模型并不意味着此 MCP 实现了每个模型的协议。视频、音乐、转录、TTS 和 Midjourney 任务需要使用各自的 API。旧版 generate_video 实现会将视频模型发送到聊天端点，现已移除。有关这些任务 API，请使用 API 文档。

服务不再将发现失败静默替换为硬编码模型列表。身份验证和发现错误会返回给客户端。类别使用公开端点元数据和基于名称的音频检测；未知类型会归入 other。

从 npm 安装

需要 Node.js 22 或更高版本。

使用 npx -y [email protected] 配置 MCP 客户端，并按下方所示设置 CRAZYROUTER_API_KEY。客户端会自动启动服务。

如需从源代码构建：

git clone https://github.com/xujfcn/crazyrouter-mcp.git
cd crazyrouter-mcp
npm ci
npm run build

Claude Desktop 或 Cursor

在 Crazyrouter 控制台中创建密钥。将以下内容添加到客户端的 MCP 配置中，并在本地替换密钥：

{
  "mcpServers": {
    "crazyrouter": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "CRAZYROUTER_API_KEY": "YOUR_CRAZYROUTER_API_KEY" }
    }
  }
}

Claude Desktop 使用其 claude_desktop_config.json；Cursor 支持 .cursor/mcp.json。编辑后重启客户端。不要提交包含真实密钥的配置。

VS Code

使用 .vscode/mcp.json 和 VS Code MCP 架构：

{
  "servers": {
    "crazyrouter": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "CRAZYROUTER_API_KEY": "${input:crazyrouter-api-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "crazyrouter-api-key", "description": "Crazyrouter API key", "password": true }
  ]
}

工具参数示例

{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply OK"}],"max_tokens":16}

根据模型文档中的架构，只使用 max_tokens 和 max_completion_tokens 之一。对于不支持可选 temperature 值的模型，请勿发送这些值。

{"category":"image"}

{"model":"gpt-image-2","prompt":"A simple blue circle on a white background","n":1}

图像输出可以是 URL 或 base64 图像。该工具通过 MCP 返回这两种格式，且不会对空结果报告成功。尺寸限制因模型而异。图像请求会产生该模型的常规费用。

价格与故障排查

• 当前模型和价格是权威信息来源；模型数量并非固定，也不存在通用折扣。
• HTTP 400：检查确切的模型 ID、端点、尺寸和其他字段。请从最简示例开始。
• HTTP 401/403：检查密钥和权限。HTTP 429：检查配额和速率限制。
• 需要原生任务 API 的模型会在推理前被聊天／图像工具拒绝。
• API 基础地址固定为 https://crazyrouter.com/v1；营销参数绝不会添加到 API 请求中。

Development

npm ci
npm run build
npm test

Tests use mocked HTTP responses through an MCP client/server connection. On 2026-10-12, live checks through the updated MCP passed for model discovery, a minimal gpt-4o-mini chat request and one gpt-image-2 image request. This does not establish that every model or media operation has been tested. Maintainers can run node tests/live-smoke.mjs; add --image to include one billable image request.

中文说明

本仓库支持文本聊天、同步图片生成、实时模型发现三个工具。模型目录会返回视频、音乐等类别，但不代表这些能力已在 MCP 中实现。旧版视频工具错误地调用聊天接口，已移除；请按 API 文档使用原生任务接口。

使用 Node.js 22+，按上面的配置通过 npx -y [email protected] 启动。也可以克隆仓库后运行 npm ci 和 npm run build，再将本地 dist/index.js 配置到 MCP 客户端。密钥通过 CRAZYROUTER_API_KEY 传入。不要将模型目录中的显示名称当作精确 API ID，也不要将推广参数添加到接口地址。

创建密钥 · 当前模型与价格

License

MIT