OpenRouter MCP 服务器
模型上下文协议 (MCP) 服务器，可与 OpenRouter.ai 丰富的模型生态系统无缝集成。通过统一、类型安全的接口访问各种 AI 模型，该接口内置缓存、速率限制和错误处理功能。
特征
模型访问
直接访问所有 OpenRouter.ai 模型
自动模型验证和能力检查
默认模型配置支持
性能优化
智能模型信息缓存（1小时有效）
自动速率限制管理
失败请求的指数退避
统一响应格式
所有响应的
ToolResult结构一致使用
isError标志清除错误标识带有上下文的结构化错误消息
Related MCP server: MindBridge MCP Server
安装
pnpm install @mcpservers/openrouterai配置
先决条件
从OpenRouter Keys获取您的 OpenRouter API 密钥
选择默认模型（可选）
环境变量
OPENROUTER_API_KEY=your-api-key-here
OPENROUTER_DEFAULT_MODEL=optional-default-model设置
添加到您的 MCP 设置配置文件（ cline_mcp_settings.json或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"
}
}
}
}响应格式
所有工具都以标准化结构返回响应：
interface ToolResult {
isError: boolean;
content: Array<{
type: "text";
text: string; // JSON string or error message
}>;
}成功案例：
{
"isError": false,
"content": [{
"type": "text",
"text": "{\"id\": \"gen-123\", ...}"
}]
}错误示例：
{
"isError": true,
"content": [{
"type": "text",
"text": "Error: Model validation failed - 'invalid-model' not found"
}]
}可用工具
聊天完成
向 OpenRouter.ai 模型发送消息：
interface ChatCompletionRequest {
model?: string;
messages: Array<{role: "user"|"system"|"assistant", content: string}>;
temperature?: number; // 0-2
}
// Response: ToolResult with chat completion data or error搜索模型
搜索并过滤可用型号：
interface ModelSearchRequest {
query?: string;
provider?: string;
minContextLength?: number;
capabilities?: {
functions?: boolean;
vision?: boolean;
};
}
// Response: ToolResult with model list or error获取模型信息
获取特定型号的详细信息：
{
model: string; // Model identifier
}验证模型
检查模型 ID 是否有效：
interface ModelValidationRequest {
model: string;
}
// Response:
// Success: { isError: false, valid: true }
// Error: { isError: true, error: "Model not found" }错误处理
服务器提供带有上下文信息的结构化错误：
// Error response structure
{
isError: true,
content: [{
type: "text",
text: "Error: [Category] - Detailed message"
}]
}常见错误类别：
Validation Error：输入参数无效API Error：OpenRouter API 通信问题Rate Limit：请求节流检测Internal Error：服务器端处理失败
处理响应：
async function handleResponse(result: ToolResult) {
if (result.isError) {
const errorMessage = result.content[0].text;
if (errorMessage.startsWith('Error: Rate Limit')) {
// Handle rate limiting
}
// Other error handling
} else {
const data = JSON.parse(result.content[0].text);
// Process successful response
}
}发展
有关以下方面的详细信息，请参阅CONTRIBUTING.md ：
开发设置
项目结构
功能实现
错误处理指南
工具使用示例
# Install dependencies
pnpm install
# Build project
pnpm run build
# Run tests
pnpm test变更日志
查看CHANGELOG.md了解最新更新，包括：
统一响应格式实现
增强的错误处理系统
类型安全接口改进
执照
该项目根据 Apache License 2.0 获得许可 - 有关详细信息，请参阅LICENSE文件。
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.