Openrouter

🚀 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 文件以獲取詳細信息。