Brave Search MCP Server

基本能力

产品定位

mcp-brave-search 是一个集成了 Brave Search API 的 MCP 服务器实现，提供网页搜索和本地搜索功能。

核心功能

• Web Search: 支持通用查询、新闻、文章搜索，具有分页和新鲜度控制功能
• Local Search: 查找商家、餐厅和服务，提供详细信息
• Flexible Filtering: 控制结果类型、安全级别和内容新鲜度
• Smart Fallbacks: 本地搜索无结果时自动回退到网页搜索

适用场景

• 信息检索
• 本地服务查找
• 开发集成搜索功能

工具列表

• brave_web_search: 执行网页搜索，支持分页和过滤
• 输入参数:
  • query (string): 搜索词
  • count (number, optional): 每页结果数（最多20）
  • offset (number, optional): 分页偏移量（最多9）
• brave_local_search: 搜索本地商家和服务
• 输入参数:
  • query (string): 本地搜索词
  • count (number, optional): 结果数量（最多20）
• 无本地结果时自动回退到网页搜索

常见问题解答

• 如何获取 API Key？
• 注册 Brave Search API 账户
• 选择计划（免费层每月提供 2,000 次查询）
• 从开发者仪表板生成 API key here

使用教程

使用依赖

需要先获取 Brave Search API Key

安装教程

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

调试方式

Docker 构建

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

许可证

该项目遵循 MIT 开源许可条款。