OpenDeepSearch
使用模型上下文协议 (MCP) 的 Perplexity Deep Research 的开源替代方案。
概述
OpenDeepSearch 是一款功能强大的研究工具，能够对复杂主题进行全面深入的研究。它结合了序列思维的结构化思维方法和 Brave Search 的搜索功能，提供详细且来源可靠的研究报告。
特征
- 综合研究：将复杂问题分解为可管理的子问题
- 迭代搜索：执行多次搜索以收集不同的信息
- 智能分析：分析搜索结果以提取相关信息
- 综合：将调查结果整合成一份连贯、结构良好的报告
- 引用：包括报告中所有信息的来源
- MCP 集成：与 Claude Desktop、Cursor 和其他 MCP 客户端无缝集成
- WebSockets ：支持与 Smithery 和其他 MCP 客户端集成
- 出版物：允许在 Smithery 平台上发布研究工具，以便于访问
安装
先决条件
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
将以下内容添加到您的 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
确保在运行 Cursor 之前设置BRAVE_API_KEY环境变量。
示例查询
- “量子计算的最新进展是什么？”
- “比较和对比缓解气候变化的不同方法”
- “解释文艺复兴对欧洲艺术的历史和影响”
- “不同可再生能源的优缺点是什么？”
工作原理
- 问题分析：系统分析主问题并将其分解为子问题
- 迭代搜索：对于每个子问题，系统使用 Brave Search API 执行搜索
- 结果分析：系统分析搜索结果以提取相关信息
- 综合：系统将调查结果整合成一份连贯的报告
- 引用：所有信息均正确引用来源
发展
设置
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research
npm install
建造
以开发模式运行
BRAVE_API_KEY=your_api_key npm run dev
测试
使用 MCP Inspector 进行测试
Для тестирования MCP сервера можно использовать MCP Inspector, который предоставляет удобный интерфейс для взаимодействия с说明：
# Установка и запуск MCP Inspector
npx @modelcontextprotocol/inspector
# Запуск сервера в другом терминале
BRAVE_API_KEY=your_api_key npm start
После запуска 检查员，откройте браузер 和 перейдите по адресу http://localhost:5173 。使用 WebSocket 并使用 URL ws://localhost:3000 。
Примеры запросов для тестирования инструментов
В интерфейсе MCP Inspector вы можете выбрать инструмент и настроить параметры запроса:
Тестирование Brave 网页搜索
{
"query": "latest quantum computing advancements",
"count": 5
}
顺序思维
{
"thought": "Начинаю анализ проблемы глобального потепления",
"thoughtNumber": 1,
"totalThoughts": 5,
"nextThoughtNeeded": true
}
深入研究
{
"query": "Сравнение различных источников возобновляемой энергии",
"action": "start",
"maxSubQuestions": 3
}
使用 Claude 或 Cursor 进行测试
После установки сервера через Smithery 和 локально, вы можете 和спользовать его с Claude Desktop 和 Cursor, выбрав соответствующий MCP сервер в настройках。
在 Smithery 上发布
要在 Smithery 平台上发布服务器：
- 确保存储库托管在 GitHub 上并且是公开的
- 在Smithery平台上注册
- 通过 GitHub 进行身份验证以连接存储库
- 转到服务器页面上的“部署”选项卡
- 点击“在 Smithery 上部署”按钮
- 按照部署设置说明进行操作
发布后，用户可以使用 Smithery CLI 安装服务器：
npx @smithery/cli install open-deep-research --client claude
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
致谢
- 受 Perplexity 深度研究启发
- 基于模型上下文协议
- 使用顺序思维方法进行结构化研究
- 由 Brave Search API 提供支持