Openroutermcp

⚡ OpenRouter MCP

每一个AI模型。一个终端。零上下文切换。

GPT-4 Claude Gemini Llama Mistral Flux +300 more

入门指南 · 特性 · 工具 · 发展

问题

你在你的AI编码助手里。你需要一个快速的GPT-4意见。或Flux生成的图像。或者对三个模型进行并排比较。这意味着：离开你的编辑器，打开浏览器，找到正确的API，复制-粘贴密钥，失去你的流。..

修复

将其添加到MCP配置中，然后执行以下操作：

{
  "openrouter": {
    "command": "npx",
    "args": ["-y", "openrouter-mcp-server"],
    "env": {
      "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
    }
  }
}

现在，OpenRouter上的每个模型都只需调用一个工具即可。聊天、图像生成、模型搜索、成本跟踪——所有这些都是内联的。

______________________________________________________________________

⚡ 入门指南

步骤1 -从获取API密钥 openrouter.ai/keys

步骤2 --添加到MCP配置(~/.claude/settings.json 或应用程序的MCP设置）：

{
  "mcpServers": {
    "openrouter": {
      "command": "npx",
      "args": ["-y", "openrouter-mcp-server"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
      }
    }
  }
}

完成。当您的MCP客户端连接时，服务器会自动启动。

Alternative: Clone & build from source

git clone https://github.com/overtimepog/OpenrouterMCP.git
cd OpenrouterMCP
bash scripts/setup.sh

______________________________________________________________________

🎯 特性

Multi-Model Chat

Talk to any of 300+ models with multi-turn context, streaming, and tool calling

Image Generation

Flux, Stable Diffusion, Gemini — control ratio, resolution, save locally

Model Comparison

Same prompt to N models, side-by-side quality, speed, and cost

Cost Tracking

Real-time spend per session, per model, per operation

______________________________________________________________________

📡 MCP工具

openrouter_chat — Chat with any model

openrouter_search_models — Advanced model search & compare

openrouter_list_models — List all models with filtering

openrouter_generate_image — Generate images

openrouter_get_credits — Check balance & usage

没有参数。返回信用额度、剩余余额、总使用量和每日/每周/每月明细。

openrouter_get_cost_summary — Cost breakdown

openrouter_get_generation — Generation stats

返回令牌、成本、延迟、型号和提供者信息。

openrouter_get_model_endpoints — Provider endpoints & routing

返回所有可用的提供商，包括延迟、正常运行时间、定价和功能。

______________________________________________________________________

📁 项目结构

OpenrouterMCP/
└── src/                    TypeScript MCP server
    ├── index.ts            Entry point
    ├── server/             Server bootstrap
    ├── api/                OpenRouter client, cache, rate limits
    ├── session/            Multi-turn conversation management
    ├── cost/               Cost tracking engine
    ├── schemas/            Shared Zod schemas
    ├── tools/              8 tool implementations
    │   ├── chat/
    │   ├── searchModels/
    │   ├── listModels/
    │   ├── imageGeneration/
    │   ├── credits/
    │   ├── costSummary/
    │   ├── generation/
    │   └── modelEndpoints/
    └── utils/              Logger, model validation

______________________________________________________________________

🛠 发展

npm install          # dependencies
npm run build        # compile
npm test             # 383 tests
npm run dev          # watch mode

______________________________________________________________________

🔍 故障排除

OPENROUTER_API_KEY not found

echo 'export OPENROUTER_API_KEY=sk-or-v1-your-key' >> ~/.zshrc && source ~/.zshrc

Invalid API key

在以下位置验证 openrouter.ai/keys 密钥正确且有效。

Model not found

型号ID使用以下格式 provider/model-name （例如。 openai/gpt-4).使用 openrouter_search_models 查找当前模型的工具——永远不要硬编码ID。

Rate limit exceeded

服务器会在您达到限制之前发出警告。升级您的OpenRouter计划或请求空间释放。

Tools not showing up

1. 检查键已设置： echo $OPENROUTER_API_KEY
2. 验证您的MCP配置是否具有正确的服务器条目
3. 重新启动MCP客户端
4. 尝试 npx -y openrouter-mcp-server 直接检查错误

______________________________________________________________________

MIT许可证