← 返回目录
O

OpenRouter MCP Server

社区
通过OpenRouter.ai集成多种AI模型的MCP服务器
GitHub 源仓库 ↗
★ 63 Stars 分类 · 开发工具 热门 源版本 3678d309d893
49FMRS · D
可靠性
6/20
安全与权限
10/20
维护活跃度
8/20
文档质量
14/20
安装易用性
11/20

该服务器提供清晰的统一响应格式和错误处理,配置灵活,但依赖OpenRouter服务。

查看 FMRS 评分方法 →

OpenRouter MCP服务器提供与OpenRouter.ai多样化模型生态系统的无缝集成。通过统一的类型安全接口访问各种AI模型,内置缓存、速率限制和错误处理功能。

工具能力

chat_completion
向OpenRouter聊天补全API发送请求,支持模型选择、消息、温度、最大token数及provider路由配置。
search_models
搜索和筛选可用模型,支持查询文本、提供商、最小上下文长度及能力过滤。
get_model_info
获取特定模型的详细信息。
validate_model
检查模型ID是否有效。

安装接入

  1. 安装Node.js和pnpm。2. 运行pnpm install @mcpservers/openrouterai。3. 从OpenRouter获取API密钥。4. 配置MCP客户端(如Claude Desktop或Cline),设置环境变量OPENROUTER_API_KEY。可选设置OPENROUTER_DEFAULT_MODEL等。
claude_desktop_config.json
{
  "mcpServers": {
    "openrouterai": {
      "command": "npx",
      "args": [
        "@mcpservers/openrouterai"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "OPENROUTER_DEFAULT_MODEL": "optional-default-model",
        "OPENROUTER_MAX_TOKENS": "1024",
        "OPENROUTER_PROVIDER_QUANTIZATIONS": "fp16,int8",
        "OPENROUTER_PROVIDER_IGNORE": "openai,anthropic"
      }
    }
  }
}

选型与风险

适合谁

  • 开发者
  • 需要访问多个AI模型的AI应用
  • MCP客户端用户

不适合谁

  • 完全离线环境
  • 需要原生OpenAI API兼容接口的用户(但本服务器提供统一封装)

所需权限

  • 需要OPENROUTER_API_KEY
  • 网络访问OpenRouter API
  • 本地运行Node.js进程

风险与副作用

  • API密钥泄露风险
  • 依赖OpenRouter服务的可用性
  • 模型配置错误可能导致请求失败

常见排障

  1. 确保OPENROUTER_API_KEY有效且未过期
  2. 检查网络连接和代理设置
  3. 验证模型ID是否正确,可使用validate_model工具
  4. 查看错误信息中的类别(Validation、API、Rate Limit、Internal)进行相应处理

使用场景

在MCP客户端中调用OpenRouter上的多种AI模型
统一管理模型路由、提供商选择和参数配置
构建需要灵活模型选择和fallback机制的AI应用

支持客户端

Claude Desktop完整支持
Cline完整支持