Brave Search MCP Server

Brave Search MCP 服务

一种集成 Brave Search API 的 MCP 服务实现，提供网页搜索和本地搜索功能。

功能

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

工具

• 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"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

在 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}"
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

构建

Docker 构建：

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

许可证

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