关键词

深度搜索网页抓取信息检索Brave SearchPuppeteer

使用说明

项目简介

brave-deep-research-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供强大的深度网页搜索能力。与传统的搜索引擎 MCP 服务器不同，该服务器不仅返回搜索结果的标题和摘要，更进一步利用 Brave Search API 获取初始结果，并结合 Puppeteer 访问网页，智能提取网页的完整内容，甚至可以探索网页中的链接，进行多层次的深入研究。这使得 LLM 能够获取更全面、更深入的网页信息，从而提升问答、研究等任务的质量。

主要功能点

  • 深度网页搜索: 不仅限于搜索结果列表，更能访问网页并提取完整内容。
  • 可配置的搜索深度: 可以设置链接追踪的深度，探索更广泛的相关信息。
  • 智能内容提取: 自动识别和提取网页主要内容，过滤广告、导航等干扰信息。
  • 元数据提取: 获取网页标题、描述等元数据。
  • 支持 Claude for Desktop 等 MCP 客户端: 可以方便地集成到支持 MCP 协议的 LLM 应用中。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
  2. 全局安装 brave-deep-research-mcp: 打开终端或命令提示符，运行以下命令进行全局安装： 
    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
  3. 配置环境变量:
    • 复制 '.env.example' 文件并重命名为 '.env'： 
      cp .env.example .env
    • 编辑 '.env' 文件，填入你的 Brave Search API 密钥。你需要在 Brave Search 开发者平台获取 API 密钥。其他环境变量可以根据需要配置，例如 'PUPPETEER_HEADLESS' (是否以无头模式运行浏览器) 和 'PAGE_TIMEOUT' (页面加载超时时间)。

服务器配置 (MCP 客户端)

以下是在 MCP 客户端 (例如 Claude for Desktop) 中配置 brave-deep-research-mcp 服务器的 JSON 配置信息。你需要将这段配置添加到你的 MCP 客户端的配置文件中。

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

配置参数说明:

  • '"brave-deep-research"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
  • '"command": "npx"': 运行服务器的命令，这里使用 'npx' 来执行全局安装的 npm 包。
  • '"args": ["@suthio/brave-deep-research-mcp"]': 传递给 'npx' 命令的参数，即要执行的 npm 包名称。
  • '"env"': 环境变量配置。
    • '"BRAVE_API_KEY": "your_brave_api_key_here"': 必须配置，替换 '"your_brave_api_key_here"' 为你实际的 Brave Search API 密钥。
    • '"PUPPETEER_HEADLESS": "true"': 可选配置，设置 Puppeteer 是否以无头模式运行。'"true"' 表示无头模式 (后台运行，不显示浏览器界面)，'"false"' 表示显示浏览器界面，默认为 '"true"'。

请注意: 你需要将上述 JSON 配置添加到你的 MCP 客户端的配置文件中。以 Claude for Desktop 为例，配置文件路径在 macOS 上是 '~/Library/Application Support/Claude/claude_desktop_config.json'，在 Windows 上是 '%APPDATA%\Claude\claude_desktop_config.json'。修改配置文件后，通常需要重启 MCP 客户端才能使配置生效。

基本使用方法

配置完成后，在 MCP 客户端中，你可以使用 'deep-search' 工具进行深度网页搜索。

使用示例 (在 Claude for Desktop 中):

  • 询问: 'Use deep-search to research the latest developments in quantum computing'
  • 询问: 'Perform a deep search on climate change mitigation strategies with depth 2'
  • 询问: 'Deep search for information about sustainable architecture, with 5 results'

工具参数:

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

  • 'query' (必填): 搜索关键词。
  • 'results' (可选): 指定要处理的搜索结果数量，默认为 3，最大值为 10。
  • 'depth' (可选): 指定链接追踪的深度，默认为 1，最大值为 3。

在 MCP 客户端中，你可以通过自然语言指令或特定的工具调用格式来使用 'deep-search' 工具，具体取决于你的 MCP 客户端的功能和使用方式。

信息

分类

网页与API

访问项目