← 返回目录

OpenRouter MCP Server

社区

通过OpenRouter.ai集成多种AI模型的MCP服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 272 / 438
Stars: ★ 64 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 11 个月前 ⚠
工具数: 4

49FMRS · D

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

最强项 · 文档质量 14/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

10/20

维护活跃度

8/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 6/20: 源代码不可用，无法验证工具实现。README 描述了统一的 ToolResult 结构和错误处理，但没有测试或 CI 证据。静态审查仅确认存在清晰的工具列表和输入模式，但实际执行行为无法确认。扣除点：缺乏实际测试和工作流。
安全与权限 10/20: 仅从 README 中获取证据。API 密钥通过环境变量处理，这是标准做法。没有发现硬编码的令牌或明显的恶意行为。然而，没有源代码或安全审计，无法评估最小权限和数据边界。由于没有找到危险默认值或秘密，因此未触发红线。扣除点：没有源代码验证，安全评估有限。
维护活跃度 8/20: 仓库活跃，有 63 颗星和 3 个开放问题。LICENSE 是 Apache-2.0。有 CHANGELOG 和 CONTRIBUTING 文件。然而，没有提交历史或发布历史，因此无法确认持续维护。版本 2.2.0 被声明，但未验证。扣除点：缺少版本控制细节。
文档质量 14/20: README 提供了详尽的设置说明，包括环境变量、客户端配置和工具输入模式示例。涵盖错误类别。似乎有良好的文档结构。可能缺少故障排除部分。根据静态证据，文档看起来稳健。
安装易用性 11/20: 安装命令是标准的 npm/pnpm 包。提供了客户端配置 JSON 示例。需要 API 密钥。这看起来是一个简单的安装过程。由于没有实际的运行时执行，无法确认所有依赖和兼容性。静态验证有限，因此得分不超过 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js

OPENROUTER_API_KEY 必填密钥 OpenRouter 的 API 密钥,必填,可在 https://openrouter.ai/keys 获取。

其他可选配置项（9 个）

OPENROUTER_DEFAULT_MODEL 可选可选,请求未指定 model 时使用的默认模型,例如 openrouter/auto。

OPENROUTER_MAX_TOKENS 可选可选,请求未指定 max_tokens 时的默认最大生成 token 数。

OPENROUTER_PROVIDER_QUANTIZATIONS 可选可选,默认的量化级别过滤列表(如 fp16,int8)。

OPENROUTER_PROVIDER_IGNORE 可选可选,默认要排除的供应商名称列表。

OPENROUTER_PROVIDER_SORT 可选可选,默认供应商排序方式:price、throughput 或 latency。

OPENROUTER_PROVIDER_ORDER 可选可选,默认的供应商优先级 JSON 数组字符串。

OPENROUTER_PROVIDER_REQUIRE_PARAMETERS 可选可选,默认布尔值,要求供应商支持所有请求参数。

OPENROUTER_PROVIDER_DATA_COLLECTION 可选可选,默认数据收集策略:allow 或 deny。

OPENROUTER_PROVIDER_ALLOW_FALLBACKS 可选可选,默认布尔值,控制首选供应商失败时是否回退。

安装Node.js和pnpm。
运行pnpm install @mcpservers/openrouterai。
从OpenRouter获取API密钥。
配置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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add openrouterai -e OPENROUTER_API_KEY=your-api-key-here -e OPENROUTER_DEFAULT_MODEL=optional-default-model -e OPENROUTER_MAX_TOKENS=1024 -e OPENROUTER_PROVIDER_QUANTIZATIONS=fp16,int8 -e OPENROUTER_PROVIDER_IGNORE=openai,anthropic -- npx @mcpservers/openrouterai

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 chat_completion、search_models、get_model_info、validate_model 四个工具;再调用 validate_model 验证一个模型 ID,若返回 { isError: false, valid: true } 即说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索支持 vision 能力且上下文长度至少 128k 的 OpenRouter 模型
获取 openai/gpt-4o 的详细模型信息
验证 anthropic/claude-3-haiku 是否为有效的模型 ID
用 anthropic/claude-3-haiku 写一段关于量化概念的简短解释,最多 500 tokens

工具能力 4

chat_completion 写入

向OpenRouter聊天补全API发送请求，支持模型选择、消息、温度、最大token数及provider路由配置。

search_models 只读

搜索和筛选可用模型，支持查询文本、提供商、最小上下文长度及能力过滤。

get_model_info 只读

获取特定模型的详细信息。

validate_model 只读

检查模型ID是否有效。

使用场景

在MCP客户端中调用OpenRouter上的多种AI模型

统一管理模型路由、提供商选择和参数配置

构建需要灵活模型选择和fallback机制的AI应用

支持客户端

Claude Desktop

Cline

依据项目文档列出，未经本站实测。

详细介绍

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