OpenDeepSearch

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

概述

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

Related MCP server: MCP Server for Deep Research

特征

• 综合研究：将复杂问题分解为可管理的子问题

• 迭代搜索：执行多次搜索以收集不同的信息

• 智能分析：分析搜索结果以提取相关信息

• 综合：将调查结果整合成一份连贯、结构良好的报告

• 引用：包括报告中所有信息的来源

• 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

本地安装

# 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环境变量。

示例查询

• “量子计算的最新进展是什么？”

• “比较和对比缓解气候变化的不同方法”

• “解释文艺复兴对欧洲艺术的历史和影响”

• “不同可再生能源的优缺点是什么？”

工作原理

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

После запуска 检查员，откройте браузер 和 перейдите по адресу 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 平台上发布服务器：

1. 确保存储库托管在 GitHub 上并且是公开的

2. 在Smithery平台上注册

3. 通过 GitHub 进行身份验证以连接存储库

4. 转到服务器页面上的“部署”选项卡

5. 点击“在 Smithery 上部署”按钮

6. 按照部署设置说明进行操作

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

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

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

致谢

• 受 Perplexity 深度研究启发

• 基于模型上下文协议

• 使用顺序思维方法进行结构化研究

• 由 Brave Search API 提供支持