OpenDeepSearch

一个使用模型上下文协议 (MCP) 的 Perplexity Deep Research 的开源替代方案。

概述

OpenDeepSearch 是一个强大的研究工具，可以对复杂主题进行全面、深入的研究。它结合了顺序思考的结构化思维方法和 Brave Search 的搜索能力，以提供详细、来源可靠的研究报告。

特性

• 全面研究: 将复杂问题分解为可管理的子问题
• 迭代搜索: 执行多次搜索以收集不同的信息
• 智能分析: 分析搜索结果以提取相关信息
• 综合: 将发现结果组合成连贯、结构良好的报告
• 引用: 包括报告中所有信息的来源
• MCP 集成: 与 Claude Desktop、Cursor 和其他 MCP 客户端无缝集成
• WebSockets: 支持与 Smithery 和其他 MCP 客户端集成
• 发布: 允许在 Smithery 平台上发布研究工具，以便轻松访问

安装

前提条件

• Node.js 16 或更高版本
• 一个 Brave Search API 密钥 (在 https://brave.com/search/api/ 获取)

NPM 安装

npm install -g open-deep-research

使用 NPX 运行

BRAVE_API_KEY=your_api_key npx open-deep-research

本地安装

# 克隆存储库
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research

# 安装依赖
npm install

# 构建项目
npm run build

# 使用 Brave Search API 运行
BRAVE_API_KEY=your_api_key npm start

通过 Smithery 安装

# 为 Claude 安装
npx @smithery/cli install open-deep-research --client claude

# 为 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

在 Cursor 中，您可以使用以下命令添加 MCP 服务器：

claude mcp add "open-deep-research" npx open-deep-research

确保在运行 Cursor 之前设置 BRAVE_API_KEY 环境变量。

示例查询

• "量子计算的最新进展是什么？"
• "比较和对比不同的气候变化减缓方法"
• "解释文艺复兴对欧洲艺术的历史和影响"
• "不同可再生能源的优缺点是什么？"

工作原理

1. 问题分析: 系统分析主要问题并将其分解为子问题
2. 迭代搜索: 对于每个子问题，系统使用 Brave Search API 执行搜索
3. 结果分析: 系统分析搜索结果以提取相关信息
4. 综合: 系统将发现结果组合成连贯的报告
5. 引用: 所有信息都正确引用来源

开发

设置

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 Inspector 进行测试

Для тестирования MCP сервера можно использовать MCP Inspector, который предоставляет удобный интерфейс для взаимодействия с инструментами:

# Установка и запуск MCP Inspector
npx @modelcontextprotocol/inspector

# Запуск сервера в другом терминале
BRAVE_API_KEY=your_api_key npm start

После запуска Inspector, откройте браузер и перейдите по адресу http://localhost:5173. Подключитесь к WebSocket серверу, используя URL 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 平台上发布服务器：

1. 确保存储库托管在 GitHub 上并且是公开的
2. 在 Smithery 平台上注册
3. 通过 GitHub 验证以连接到存储库
4. 转到服务器页面上的“部署”选项卡
5. 单击“在 Smithery 上部署”按钮
6. 按照部署设置说明进行操作

发布后，用户可以使用 Smithery CLI 安装服务器：

npx @smithery/cli install open-deep-research --client claude

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 灵感来自 Perplexity Deep Research
• 构建在模型上下文协议之上
• 使用顺序思考方法进行结构化研究
• 由 Brave Search API 提供支持