OpenDeepSearch
使用模型上下文协议（MCP）的困惑深度研究的开源替代方案。
概述
OpenDeepSearch是一个强大的研究工具，可以对复杂的主题进行全面、深入的研究。它将顺序思维的结构化思维方法与Brave search的搜索功能相结合，提供详细、来源丰富的研究报告。
特性
- 综合研究：将复杂问题分解为可管理的子问题
- 迭代搜索：执行多次搜索以收集各种信息
- 智能分析：分析搜索结果以提取相关信息
- 合成：将调查结果合并成一份连贯、结构良好的报告
- 引用：包括报告中所有信息的来源
- MCP集成：与Claude Desktop、Cursor和其他MCP客户端无缝集成
- WebSockets：支持与Smithery和其他MCP客户端的集成
- 出版物：允许在Smithery平台上发布研究工具，以便于访问
安装
先决条件
- Node.js 16或更高版本
- 勇敢的搜索API密钥（在 https://brave.com/search/api/)
NPM安装
npm install -g open-deep-research使用NPX运行
BRAVE_API_KEY=your_api_key npx open-deep-research本地安装
# Clone the repository
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research
# Install dependencies
npm install
# Build the project
npm run build
# Run with Brave Search API
BRAVE_API_KEY=your_api_key npm start通过Smithery安装
# Install for Claude
npx @smithery/cli install open-deep-research --client claude
# Install for Cursor
npx @smithery/cli install open-deep-research --client cursor通过Smithery安装时，系统将提示您输入Brave Search API密钥。
用法
使用克劳德桌面
将以下内容添加到您的Claude Desktop配置中：
{
"mcpServers": {
"open-deep-research": {
"command": "npx",
"args": [
"-y",
"open-deep-research"
],
"env": {
"BRAVE_API_KEY": "your_api_key_here"
}
}
}
}带光标
在Cursor中，您可以通过以下方式添加MCP服务器：
claude mcp add "open-deep-research" npx open-deep-research确保设置 BRAVE_API_KEY 运行Cursor之前的环境变量。
查询示例
- “量子计算的最新进展是什么？”
- “比较和对比缓解气候变化的不同方法”
- “解释文艺复兴对欧洲艺术的历史和影响”
- “不同可再生能源的优缺点是什么？”
运作原理
- 问题分析：该系统分析主要问题并将其分解为子问题
- 迭代搜索：对于每个子问题，系统使用Brave Search API进行搜索
- 结果分析：系统分析搜索结果以提取相关信息
- 合成：该系统将调查结果合并为一份连贯的报告
- 引用：所有信息均正确引用来源
发展
设置
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research
npm install构建
npm run build以开发模式运行
BRAVE_API_KEY=your_api_key npm run dev测试
MCP检验员测试
您可以使用MCP Inspector测试MCP服务器，它提供了一个方便的接口，用于与工具交互：
# Установка и запуск MCP Inspector
npx @modelcontextprotocol/inspector
# Запуск сервера в другом терминале
BRAVE_API_KEY=your_api_key npm start启动Inspector后，打开浏览器并转到http://localhost:5173.使用URL连接到WebSocket服务器 ws://localhost:3000.
测试工具的查询示例
在MCP Inspector界面中，您可以选择工具并配置查询设置：
Brave Web Search测试
{
"query": "latest quantum computing advancements",
"count": 5
}Sequential Thinking测试
{
"thought": "Начинаю анализ проблемы глобального потепления",
"thoughtNumber": 1,
"totalThoughts": 5,
"nextThoughtNeeded": true
}Deep Research测试
{
"query": "Сравнение различных источников возобновляемой энергии",
"action": "start",
"maxSubQuestions": 3
}使用Claude或Cursor进行测试
通过Smithery或本地安装服务器后，可以通过在设置中选择相应的MCP服务器与Claude Desktop或Cursor一起使用它。
Smithery出版社
要在Smithery平台上发布服务器，请执行以下操作：
- 确保存储库托管在GitHub上并且是公开的
- 在 史密瑟里 平台
- 通过GitHub进行身份验证以连接存储库
- 转到服务器页面上的“部署”选项卡
- 点击“在Smithery部署”按钮
- 按照部署设置说明进行操作
发布后，用户可以使用Smithery CLI安装服务器：
npx @smithery/cli install open-deep-research --client claude贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
致谢
- 受到困惑深度研究的启发
- 基于模型上下文协议构建
- 使用顺序思维方法进行结构化研究
- 由Brave Search API提供支持