OpenRouter Agents MCP Server
2025.03.30
3
JavaScript研究代理模型协调语义搜索开发效率内容生成
OpenRouter Agents MCP Server 是一个基于模型上下文协议（MCP）的服务实现，专为OpenRouter设计，提供复杂的研究代理能力。该服务器允许您的对话式LLM将研究任务委托给一个由Claude研究协调器管理的多代理系统，这些代理由各种OpenRouter模型驱动。核心功能包括多阶段规划、并行执行、上下文感知的细化、语义知识库和自适应合成等。适用于需要高效、全面研究能力的场景，如学术研究、市场分析和技术调研等。
View on GitHub
Overview
基本能力
产品定位
OpenRouter Agents MCP Server 是一个专为OpenRouter设计的模型上下文协议（MCP）服务器，提供复杂的研究代理能力，帮助用户高效完成研究任务。
核心功能
- 多代理协调：分层系统，包含规划、研究和上下文代理角色。
- 向量嵌入数据库：使用PGLite和pgvector进行语义知识存储。
- 轮询负载均衡：将研究任务分配给不同模型以获得最佳结果。
- 自适应回退系统：当主要研究失败时，自动降级到低成本模型。
- 多阶段规划：Claude 3.7 Sonnet将复杂查询分解为专门的子问题。
- 并行执行：在多个LLM上并行执行研究以获得全面结果。
- 上下文感知细化：识别并填补初始研究中的空白。
- 语义知识库：向量搜索找到相关历史研究以增强新查询。
- 自适应合成：上下文代理将发现结果与可定制的受众级别和格式集成。
适用场景
- 学术研究
- 市场分析
- 技术调研
- 内容生成
工具列表
- Basic Tool Testing：测试所有MCP工具是否正常工作。
- MCP Server Testing：测试MCP服务器实现，包括所有传输选项。
- Research Agent Testing：测试核心研究代理功能，包括实际的OpenRouter API调用。
常见问题解答
- 连接问题：确保Claude的开发者设置与服务器配置匹配。
- API密钥错误：验证您的OpenRouter API密钥是否正确。
- 未找到代理：如果规划失败，确保Claude正确解析XML。
- 模型错误：检查指定的模型是否在您的OpenRouter账户中可用。
使用教程
使用依赖
- Node.js（推荐v18或更高版本）和npm
- Git
- OpenRouter API密钥（在https://openrouter.ai/获取）
安装教程
- 克隆仓库：
bash git clone https://github.com/wheattoast11/openrouter-deep-research-mcp.git cd openrouter-agents - 安装依赖：
bash npm install - 创建并配置
.env文件：bash cp .env.example .env编辑.env文件并添加您的OpenRouter API密钥：dotenv OPENROUTER_API_KEY=your_api_key_here
调试方式
- 启动服务器：
bash npm start - 测试工具：
bash test-all-tools.batbash test-mcp-server.jsbash test-research-agent.js