Brave Search MCP Server

Brave Search MCP 服务

利用 Brave Search API 进行网页和本地搜索的 MCP 服务，支持可选的 HTTP 代理配置。

此仓库从 Model Context Protocol servers 分叉而来，并使用库 node-fetch-native 替换了原生 fetch 实现。

如果设置了 http_proxy 和 https_proxy 环境变量，服务默认会使用它们通过代理服务发送请求。 你也可以设置 BRAVE_SEARCH_PROXY 环境变量，以使用其他代理服务。

功能

• 网页搜索：支持一般查询、新闻和文章，并提供分页及时间范围控制
• 本地搜索：查找商家、餐厅和服务，并提供详细信息
• 灵活筛选：控制结果类型、安全级别和内容时效性
• 智能回退：本地搜索未找到结果时，会自动回退到网页搜索

工具

• brave_web_search

  • 执行网页搜索，支持分页和筛选
  • 输入：
    • query（字符串）：搜索词
    • count（数字，可选）：每页结果数（最多 20 条）
    • offset（数字，可选）：分页偏移量（最大为 9）

• brave_local_search

  • 搜索本地商家和服务
  • 输入：
    • query（字符串）：本地搜索词
    • count（数字，可选）：结果数（最多 20 条）
  • 未找到本地结果时，会自动回退到网页搜索

配置

获取 API 密钥

1. 注册 Brave Search API 账户
2. 选择套餐（提供免费套餐，每月可查询 2,000 次）
3. 在开发者控制面板中生成 API 密钥

在 Claude Desktop 中使用

将以下内容添加到 claude_desktop_config.json：

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@kwp-lab/mcp-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

在 VS Code 中使用

如需快速安装，请使用下面的一键安装按钮……

如需手动安装，请将以下 JSON 代码块添加到 VS Code 的用户设置（JSON）文件中。按下 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 即可完成操作。

也可以将其添加到工作区中名为 .vscode/mcp.json 的文件中。这样便可以与他人共享此配置。

请注意，.vscode/mcp.json 文件中不需要 mcp 键。

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@kwp-lab/mcp-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

构建

Docker 构建：

docker build -t mcp/brave-search:latest -f ./Dockerfile .

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。