OpenRouter Agents MCP Server

OpenRouter代理MCP服务器

](https://www.npmjs.com/package/@terminals-tech/openrouter-agents)  ](https://github.com/terminals-tech/openrouter-agents)

用于多代理AI研究的生产MCP服务器。计划、并行、综合。

安装

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

克劳德代码一行：

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（）语法，配置模式修复
• 快递5 --从Express 4升级；现代路径模式，请求查询处理
• 可流式传输的HTTP --主传输（SSE作为传统回退而弃用）
• 断路器 -具有可配置阈值的API模型容错
• 基于嵌入的模型路由 --模型选择的局部向量相似性（无LLM调用）
• 持久化存储 --默认情况下，报告、作业、知识图在会话中持续存在

macOS/Node 25注意事项：化妆品 libc++abi: mutex lock failed 关机时可能会出现消息。这是无害的——数据在关机前会被检查。集 DB_AUTO_HEAL=true 用于内存模式（无持久性，无消息）。

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

配置

集 OPENROUTER_API_KEY 在您的环境中，然后通过配置 .env 或 .mcp.json:

完整ENV参考

.mcp.json example (team-shareable)

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

多客户端设置

运输方式

STDIO是默认的传输方式 MCP规范.使用 --http 明确用于HTTP模式。

客户端特定设置

Jan AI

1. 在设置中启用MCP服务器→ 高级→ 实验性
2. 单击+添加服务器
3. 配置：

- 姓名： openrouter-agents - 命令： npx - 论据： @terminals-tech/openrouter-agents - 环境： OPENROUTER_API_KEY=sk-or-...

注意：STDIO现在是默认值-否 --stdio 旗帜需要。

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

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

Continue / Zed / Other MCP Clients

标准MCP配置-默认为STDIO，不需要标志：

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

特征矩阵

型号（v2.0.0）

高成本层

低成本层

模型是通过基于嵌入的路由选择的——查询嵌入与模型域配置文件相匹配，而无需LLM调用。

工具

Research

Knowledge Base

Session & Graph

Rail Protocol

Utility

MCP合规性

符合 MCP规范2025-11-25 （稳定，AAIF/Linux基金会治理）。

完整合规报告

建筑

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)
└─────────────────┘

核心摘要

断路器

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

国家： 关闭 （正常）-> 打开 （失败，请求被拒绝）-> 半开的 （测试恢复）。

传输（v2.0.0）

链接

• 主页： 终端技术
• npm： @终端技术/开放路由器代理
• github： 终端技术/开放路由器代理
• 文件： CLAUDE.md | 工具样式 | 入门指南

释放

通过以下方式自动发布 请释放:

1. 推动传统承诺 main （例如。 feat:, fix:, chore:)
2. 发布请打开一个版本碰撞PR
3. 合并PR→ GitHub Release已自动创建
4. npm publish通过CI发布时触发

手动发布：

npm test && npm publish --access public

______________________________________________________________________

版本： 2.0.0 | MCP-SDK： 1.27.1 | MCP规范： 2025-11-25 | 作者 Tej Desai | 许可证： 麻省理工学院