STARWARCLOUD STARWAR.AI
返回市场
勇敢深研服务器

勇敢深研服务器

作者：suthio4 星标更新：2025-03-11
安装使用来源：spider==github.com

项目介绍

@suthio/brave-deep-research-mcp

这是一个结合了Brave搜索引擎与Puppeteer驱动的内容提取功能的Model Context Protocol (MCP)服务器，用于深度研究。此服务器允许AI助手不仅检索搜索结果，还能访问页面以提取完整内容并探索链接页面，从而执行全面的网络搜索。

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

标准Brave搜索引擎MCP服务器：

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

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

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

示例查询中的实际差异

对于“气候变化缓解技术”这样的查询：

标准Brave搜索引擎MCP：

标题："最新气候变化缓解技术 - 示例网站"
URL："https://example.com/climate-tech"
摘要："正在开发多种技术来缓解气候变化，包括碳捕获……"

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

Brave深度研究MCP：

# 最新气候变化缓解技术 - 示例网站
URL: https://example.com/climate-tech

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

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

功能

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

安装

# 从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文件：

# 复制示例环境文件
cp .env.example .env

# 编辑文件添加您的Brave API密钥和其他设置
nano .env

环境变量

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

使用方法

从命令行运行

# 如果已全局安装
brave-deep-research-mcp

# 或直接从包运行
npx @suthio/brave-deep-research-mcp

# 或克隆后本地运行
npm start

与Claude for Desktop一起使用

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

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

  1. 编辑Claude for Desktop配置文件：

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

  2. 在mcpServers部分添加以下内容：

{
  "mcpServers": {
    "brave-deep-research": {
      "command": "npx",
      "args": ["@suthio/brave-deep-research-mcp"],
      "env": {
        "BRAVE_API_KEY": "your_brave_api_key_here",
        "PUPPETEER_HEADLESS": "true"
      }
    }
  }
}
  1. 重启Claude for Desktop
  2. 您现在可以在对话中使用深度搜索工具

示例查询

  • “使用深度搜索研究量子计算的最新发展”
  • “对气候变化缓解策略进行深度搜索，深度为2”
  • “深度搜索关于可持续建筑的信息，结果数量为5”

工具参数

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

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

开发

# 克隆仓库
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搜索引擎API进行搜索以获取初始结果
  2. 对于每个搜索结果，它启动一个Puppeteer浏览器访问该页面
  3. 它从每个页面中提取主要内容、元数据和链接
  4. 如果深度大于1，则跟随页面上的链接并重复该过程
  5. 所有提取的内容都会被格式化并返回给AI助手

许可证

MIT