Brave Deep Research MCP

@suthio/勇敢深入研究mcp

一种模型上下文协议（MCP）服务器，将Brave Search与Puppeter支持的内容提取相结合，以实现深度研究功能。该服务器允许AI助手执行全面的网络搜索，不仅可以检索搜索结果，还可以访问页面以提取完整内容并探索链接页面。

与标准Brave Search MCP服务器的比较

标准Brave搜索MCP服务器：

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

Brave Deep Research MCP服务器（本项目）：

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

示例查询中的实际差异

对于“气候变化减缓技术”这样的问题：

标准勇敢搜索MCP:

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

（仅限于这些搜索结果片段）

勇敢深入研究MCP:

# Latest Climate Change Mitigation Technologies - Example Site
URL: https://example.com/climate-tech

## Content
Carbon capture and storage (CCS) technology has advanced significantly in recent years. The latest direct air capture facilities can now remove CO2 at a cost of $250 per ton, down from $600 just five years ago. Implementation challenges remain, including...

[Followed by several pages of detailed content from the original page and linked pages]

特性

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

安装

# Install from npm
npm install -g @suthio/brave-deep-research-mcp

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

配置

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

# Copy the example env file
cp .env.example .env

# Edit the file to add your Brave API key and other settings
nano .env

环境变量

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

用法

从命令行运行

# If installed globally via npm
brave-deep-research-mcp

# Or run directly from the package
npx @suthio/brave-deep-research-mcp

# Or run locally after cloning
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

1. 将以下内容添加到 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
2. 现在，您可以在对话中使用深度搜索工具

查询示例

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

刀具参数

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

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

发展

# Clone the repository
git clone https://github.com/suthio/brave-deep-research-mcp.git
cd brave-deep-research-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build the project
npm run build

运作原理

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

许可证

麻省理工学院