🚀 OpenRouter MCP 服务器

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

🚀 快速开始

本项目是一个提供与 OpenRouter.ai 多样化模型生态系统无缝集成的 MCP 服务器。借助它，你可以通过统一、类型安全的接口访问多种人工智能模型，同时内置了缓存、速率限制和错误处理功能。

✨ 主要特性

• 模型访问

  • 直接访问所有 OpenRouter.ai 模型
  • 自动进行模型验证和能力检查
  • 支持默认模型配置

• 性能优化

  • 智能的模型信息缓存（1 小时过期）
  • 自动管理速率限制
  • 失败请求的指数退避

• 错误处理

  • 统一的响应格式
  • 明确的错误分类和消息
  • 灵活的错误处理机制

📦 安装指南

# 安装依赖
pnpm install

# 构建项目
pnpm run build

# 运行测试
pnpm test

📚 详细文档

配置指南

环境变量

设置以下环境变量以配置服务器行为：

示例配置

在项目根目录下创建一个 .env 文件：

PORT=3001
DEBUG=true
CACHE_ENABLED=false
RATE_LIMIT=200

功能详解

统一响应格式

所有 API 响应均采用以下统一格式：

{
  "success": boolean,
  "data": any,
  "error": {
    "code": string,
    "message": string
  }
}

• success: 表示操作是否成功。
• data: 成功时返回的数据。
• error: 失败时返回的错误信息。

错误处理

服务器定义了以下错误代码和消息：

示例响应

成功示例：

{
  "success": true,
  "data": {
    "message": "Hello, World!"
  }
}

失败示例：

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "请求速率超出限制"
  }
}

开发指南

贡献指南

请参考 CONTRIBUTING.md 获取详细的开发信息，包括：

• 开发环境搭建
• 项目结构说明
• 功能实现规范
• 错误处理准则
• 工具使用示例

代码规范

遵循以下代码规范以确保代码质量：

1. 使用 TypeScript 实现所有接口。
2. 遵循模块化编程原则，每个功能独立为一个模块。
3. 在函数和类上添加详细的注释。

变更日志

请参考 CHANGELOG.md 查看最近更新，包括：

• 统一响应格式的实现
• 错误处理系统的增强
• 类型安全接口的改进

📄 许可证

本项目采用 Apache License 2.0 协议，具体内容请查看 LICENSE 文件以获取详细信息。