基本能力
产品定位
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.bat
bash
test-mcp-server.js
bash
test-research-agent.js