多智能体AI研究服务器

OpenRouter Agents MCP Server是一个用于多智能体AI研究的MCP服务器,支持规划、并行化和综合处理。

  • by wheattoast11
  • JavaScript
  • 本地部署
  • 55 星标
  • 更新于
在 GitHub 查看 wheattoast11/openrouter-deep-research-mcp

使用说明

OpenRouter代理MCP服务器

用于多代理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:

变量 默认值 描述
OPENROUTER_API_KEY 必需的 OpenRouter API密钥
OPENROUTER_API_KEYS (可选) 逗号分隔的OpenRouter键用于旋转
OPENROUTER_KEY_COOLDOWN_MS 5000 故障后每个键的基础冷却
SERVER_PORT 3002 HTTP服务器端口
MODE ALL AGENT, MANUAL,或 ALL
EMBEDDING_ROUTING_ENABLED true 启用基于嵌入的模型路由
INDEXER_ENABLED true 启用知识索引

完整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客户端(Claude,Jan AI,继续)
HTTP --http Web应用程序、共享服务器

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": "..." }
}

特征矩阵

功能 所有MCP客户端 仅限Claude代码
核心研究工具 ✓ ✓
知识库 ✓ ✓
会话/图形工具 ✓ ✓
铁路协议工具 ✓ ✓
Slash命令 - ✓

型号(v2.0.0)

高成本层

模型 域
anthropic/claude-sonnet-4.5 推理、技术、一般、创造性
anthropic/claude-opus-4.6 推理、技术、一般、创造性
openai/gpt-5.2-chat 推理、技术、一般
openai/gpt-5.3-codex 编码、技术、推理
google/gemini-3-pro-preview 推理、技术、一般
qwen/qwen3-coder 编码、编辑、技术

低成本层

模型 域
google/gemini-3-flash-preview 编码、编辑、技术
anthropic/claude-haiku-4.5 一般、技术、推理
deepseek/deepseek-chat-v3.1 一般、推理、技术、编码
deepseek/deepseek-v3.2 一般、推理、技术、编码
openai/gpt-oss-120b 一般、推理、搜索

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

工具

Research
工具 说明
research 异步研究(返回job_id)
conduct_research 将研究与流媒体同步
batch_research 并行批处理查询
research_follow_up 情境感知跟进
agent 统一入口点(自动路线)
Knowledge Base
工具 说明
search 混合BM25+矢量搜索
retrieve 索引或SQL查询
query 带参数的SQL SELECT
get_report 按ID获取报告
history 列出最近的报告
Session & Graph
工具 说明
undo / redo 会话时间旅行
checkpoint 命名保存点
fork_session 创建备用时间线
graph_traverse 探索知识图谱
graph_clusters 查找节点群集
graph_pagerank 重要性排名
Rail Protocol
工具 说明
list_rails 列出铁路、隧道、路线、共识
explain_rail 详细的铁路/隧道配置
list_routes 所有已定义的路线
list_tunnels 主动代理到代理隧道
list_consensus 流媒体共识会议
Utility
工具 说明
ping 健康检查
get_server_status 全面诊断
job_status 检查异步作业
date_time 当前时间戳
calc 数学评估
list_tools 可用工具

MCP合规性

符合 MCP规范2025-11-25 (稳定,AAIF/Linux基金会治理)。

功能 SEP 状态
JSON-RPC 2.0 核心 兼容
工具/资源/提示 核心 符合要求
任务协议 SEP-1686 符合
使用工具取样 SEP-1577 符合要求
获奖 SEP-1036 合规
MCP应用程序 SEP-1865 符合要求
企业身份验证 SEP-990 符合要求
客户端元数据 SEP-991 符合要求

完整合规报告

建筑

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模型容错
参数标准化 声明式别名系统(q→query, cost→costPreference)
RoleShift协议 双向服务器↔客户通过MCP采样/启发
嵌入式路由器 基于局部矢量的模型选择 @terminals-tech/embeddings

断路器

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

变量 默认值 描述
RAIL_CIRCUIT_BREAKER true 启用断路器
RAIL_CIRCUIT_THRESHOLD 5 跳闸前故障
RAIL_CIRCUIT_RESET_MS 120000 恢复超时(ms)

国家: 关闭 (正常)-> 打开 (失败,请求被拒绝)-> 半开的 (测试恢复)。

传输(v2.0.0)

运输 状态 用例
流式HTTP 主要的,重要的 所有新集成
SSE 已弃用 仅与旧版兼容
STDIO 默认 MCP客户端(Claude,Jan AI,继续)

链接

释放

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

  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 | 许可证: 麻省理工学院