HelloWorld
登录
s

suthio

rag-systemsbrowser-automationsearch

296 查看 · 2026-07-07 更新

@suthio/brave-deep-research-mcp

这是一个结合了Brave搜索和Puppeteer驱动的内容提取的模型上下文协议（MCP）服务器，用于提供深度研究功能。该服务器不仅能够检索搜索结果，还能访问页面以提取完整内容并探索链接页面，从而允许AI助手执行全面的网络搜索。

与标准Brave搜索MCP服务器的比较

标准Brave搜索MCP服务器：

  • 搜索能力：使用Brave Search API执行基本的网络搜索
  • 数据检索：仅返回API提供的搜索结果（标题、URL和摘要）
  • 内容深度：无法访问搜索摘要之外的完整网页内容
  • 页面探索：没有访问页面或跟随链接的能力
  • 信息范围：仅限于搜索结果中可用的简要信息
  • 内容处理：没有内容提取或清理功能
  • 自定义：仅限于基本搜索参数（查询、数量、偏移量）
  • 用例：最适合只需要概览的快速搜索

Brave深度研究MCP服务器（本项目）：

  • 搜索能力：使用Brave Search API获取初始结果，然后通过网页抓取增强
  • 数据检索：从每个搜索结果中提取完整的页面内容
  • 内容深度：提供带有主要内容提取的完整网页内容
  • 页面探索：可以遍历链接以探索相关内容，并且探索深度可配置
  • 信息范围：访问多个相关页面上的综合信息
  • 内容处理：智能识别并提取主要内容，过滤掉导航、广告、页脚等
  • 自定义：可配置的探索深度、结果数量、无头模式和超时时间
  • 用例：非常适合需要详细信息和上下文的深入研究

示例查询中的实际差异

对于“climate change mitigation technologies”这样的查询：

标准Brave搜索MCP：

标题: "Latest Climate Change Mitigation Technologies - Example Site" URL: "https://example.com/climate-tech" 摘要: "Various technologies are being developed to mitigate climate change, including carbon capture..."

（仅限于这些搜索结果摘要）

Brave深度研究MCP：

最新的气候变化缓解技术 - 示例网站

URL: https://example.com/climate-tech

内容

碳捕获和存储（CCS）技术近年来取得了显著进展。最新的直接空气捕获设施现在可以以每吨250美元的成本去除CO2，而五年前这一成本为600美元。实施挑战仍然存在，包括...

[接下来是来自原始页面及其链接页面的几页详细内容]

功能

  • 深度搜索：超越搜索结果，提取完整的页面内容
  • 可配置深度：指定从初始结果开始跟随多少层级的链接
  • 内容提取：智能识别并从页面中提取主要内容
  • 元数据提取：获取标题、描述和结构化内容
  • 调试模式：可配置的日志记录以进行故障排除
  • 无头模式切换：在可见或无头模式下运行浏览器

安装

bash

从npm安装

npm install -g @suthio/brave-deep-research-mcp

或者克隆仓库

git clone https://github.com/suthio/brave-deep-research-mcp.git cd brave-deep-research-mcp npm install npm run build

配置

基于提供的.env.example创建一个.env文件：

bash

复制示例环境文件

cp .env.example .env

编辑文件以添加您的Brave API密钥和其他设置

nano .env

环境变量

  • BRAVE_API_KEY：您的Brave Search API密钥（必需）
  • PUPPETEER_HEADLESS：是否以无头模式运行Puppeteer（默认：true）
  • PAGE_TIMEOUT：页面加载的超时时间（毫秒，默认：30000）- DEBUG_MODE: 启用详细的调试日志（默认：false）

用法

从命令行运行

bash

如果通过 npm 全局安装

brave-deep-research-mcp

或者直接从包中运行

npx @suthio/brave-deep-research-mcp

或者在克隆后本地运行

npm start

与 Claude for Desktop 一起使用

要将此服务器与 Claude for Desktop 一起使用：

  1. 安装包： bash npm install -g @suthio/brave-deep-research-mcp

  2. 编辑 Claude for Desktop 的配置文件：

    • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
    • 在 Windows 上：%APPDATA%Claudeclaude_desktop_config.json

  3. 在 mcpServers 部分添加以下内容： json { "mcpServers": { "brave-deep-research": { "command": "npx", "args": ["@suthio/brave-deep-research-mcp"], "env": { "BRAVE_API_KEY": "your_brave_api_key_here", "PUPPETEER_HEADLESS": "true" } } } }

  4. 重启 Claude for Desktop

  5. 现在你可以在对话中使用 deep-search 工具了

示例查询

  • "使用 deep-search 研究量子计算的最新进展"
  • "对气候变化缓解策略进行深度为 2 的深度搜索"
  • "深度搜索可持续建筑的信息，返回 5 条结果"

工具参数

deep-search 工具接受以下参数：

  • query（必需）：搜索查询
  • results（可选）：要处理的搜索结果数量（默认：3，最大：10）
  • depth（可选）：每个结果的链接遍历深度（默认：1，最大：3）

开发

bash

克隆仓库

git clone https://github.com/suthio/brave-deep-research-mcp.git cd brave-deep-research-mcp

安装依赖

npm install

以开发模式运行

npm run dev

构建项目

npm run build

工作原理

  1. 该工具首先使用 Brave Search API 进行搜索以获取初始结果
  2. 对于每个搜索结果，它会启动一个 Puppeteer 浏览器来访问页面
  3. 从每个页面提取主要内容、元数据和链接
  4. 如果深度 > 1，它会跟随页面上的链接并重复该过程
  5. 所有提取的内容都会被格式化并返回给 AI 助手

许可证

MIT

服务配置

[{'mcpServers': {'brave-deep-research': {'args': ['@suthio/brave-deep-research-mcp'], 'command': 'npx', 'env': {'BRAVE_API_KEY': 'your_brave_api_key_here', 'PUPPETEER_HEADLESS': 'true'}}}}]

来源