OpenRouter Agents MCP Server

OpenRouter Agents MCP 服务

面向多 Agent AI 研究的生产级 MCP 服务。规划、并行处理、综合。

安装

npx @terminals-tech/openrouter-agents --stdio

Claude Code 单行命令：

claude mcp add openrouter-agents -- npx @terminals-tech/openrouter-agents --stdio

新增内容（v2.0.0）

• MCP SDK 1.27.1 — registerTool/registerPrompt/registerResource API、安全修复
• Zod 4 — 从 Zod 3 升级；z.record() 语法、配置架构修复
• Express 5 — 从 Express 4 升级；现代路径模式、req.query 处理
• Streamable HTTP — 主要传输方式（SSE 已弃用，仅作为旧版回退方案）
• 熔断器 — 模型 API 容错，阈值可配置
• 基于嵌入的模型路由 — 使用本地向量相似度选择模型（不调用 LLM）
• 持久化存储 — 报告、任务和知识图谱默认跨会话持久化

macOS/Node 25 注意事项：关闭时可能出现一条表面上的 libc++abi: mutex lock failed 消息。这不会造成影响——数据会在关闭前写入检查点。设置 DB_AUTO_HEAL=true 可启用内存模式（不持久化，也不会显示该消息）。

完整更新日志 | 扩展指南 | MCP 合规报告

配置

在环境中设置 OPENROUTER_API_KEY，然后通过 .env 或 .mcp.json 配置：

完整环境变量参考

{
  "mcpServers": {
    "openrouter-agents": {
      "command": "npx",
      "args": ["@terminals-tech/openrouter-agents", "--stdio"],
      "env": {
        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
        "INDEXER_ENABLED": "true"
      }
    }
  }
}

多客户端设置

传输模式

根据 MCP 规范，STDIO 是默认传输方式。HTTP 模式需显式使用 --http。

针对客户端的设置

{
  "mcpServers": {
    "openrouter-agents": {
      "command": "npx",
      "args": ["@terminals-tech/openrouter-agents"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}

{
  "command": "npx",
  "args": ["@terminals-tech/openrouter-agents"],
  "env": { "OPENROUTER_API_KEY": "..." }
}

功能矩阵

模型（v2.0.0）

高成本层级

低成本层级

模型通过基于嵌入的路由进行选择——查询嵌入会与模型领域配置文件匹配，无需调用大模型。

工具

MCP 合规性

符合 MCP 规范 2025-11-25（稳定版，由 AAIF/Linux Foundation 治理）。

完整合规性报告

架构

User Query
    │
    ▼
┌─────────────────┐
│  Planning Agent  │ ─── Decomposes into sub-queries
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌───────┐ ┌───────┐
│Agent 1│ │Agent N│ ─── Parallel research (embedding-routed models)
└───┬───┘ └───┬───┘
    │         │
    ▼         ▼
┌─────────────────┐
│   Synthesizer   │ ─── Consensus + citations (Signal protocol)
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Knowledge Base  │ ─── PGlite + pgvector (persistent)
└─────────────────┘

核心抽象

Circuit Breaker

防止模型 API 故障级联。可通过环境变量配置：

状态：closed（正常）-> open（故障中，拒绝请求）-> half-open（测试恢复情况）。

传输方式（v2.0.0）

链接

• 主页： terminals.tech
• npm： @terminals-tech/openrouter-agents
• GitHub： terminals-tech/openrouter-agents
• 文档： CLAUDE.md | 工具模式 | 入门指南

发布

发布流程通过 release-please 自动执行：

1. 将符合 Conventional Commits 规范的提交推送到 main（例如 feat:、fix:、chore:）
2. release-please 会创建一个版本升级 PR
3. 合并 PR → 自动创建 GitHub Release
4. 发布时由 CI 触发 npm 发布

手动发布：

npm test && npm publish --access public

版本： 2.0.0 | MCP SDK： 1.27.1 | MCP 规范： 2025-11-25 | 作者： Tej Desai | 许可证： MIT