Brave Search MCP：让 LLM 联网搜索的开箱即用方案

简介

Brave Search MCP 是 ModelContextProtocol 官方仓库维护的网络搜索服务器。它把 Brave Search API 包装为 MCP 工具，让任何兼容 MCP 的客户端（Claude Code、Cursor、VS Code 等）都能通过统一协议调用搜索引擎，无需各自实现爬虫、无需关心反爬、无需维护搜索结果解析。

相较于 Tavily、SerpAPI 等闭源搜索 API，Brave Search 的优势在于：

独立索引：Brave 自建搜索索引，不依赖 Google/Bing，覆盖 60 亿网页
隐私优先：默认不追踪用户、不个性化过滤（"filter bubble"）
免费额度：每月 2000 次免费查询，足够个人开发与测试
多端点：网页、新闻、图片、本地四类搜索一次接入

核心能力

工具名	用途	关键参数
`brave_web_search`	通用网页搜索	`query`、`count`（默认 10）、`offset`
`brave_news_search`	新闻搜索（最近 7 天优先）	`query`、`count`、`freshness`
`brave_image_search`	图片搜索	`query`、`count`、`safesearch`
`brave_local_search`	本地商家搜索	`query`、`country`、`language`

返回字段包含标题、URL、摘要、发布时间、来源域名，MCP 客户端可直接消费。

获取 API Key

访问 https://brave.com/search/api/
注册账号并选择 Free Plan（每月 2000 次查询）
在 Dashboard 复制 API Key（形如 BSA-xxxxxxxxxxxxxxxx）

各客户端配置示例

Claude Code（CLI）

编辑 ~/.claude/claude_desktop_config.json：

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

启动 Claude Code 后输入 /mcp 即可看到 brave-search 已连接。

Cursor

编辑 ~/.cursor/mcp.json（结构与 Claude Desktop 相同）：

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

在 Cursor 设置 → MCP 中可查看连接状态。

VS Code（含 Continue / Cline 插件）

Continue 插件 编辑 ~/.continue/config.json：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-brave-search"] },
        "env": { "BRAVE_API_KEY": "BSA-your_key_here" }
      }
    ]
  }
}

Cline 插件 通过 Cline: MCP Settings 命令打开 cline_mcp_settings.json，结构与 Claude Desktop 一致。

实战场景

场景 1：让 Cursor 调研最新框架版本

在 Cursor 中直接提问：

"查一下 Next.js 15 的 App Router 相比 14 有哪些破坏性变更，引用官方 changelog"

Cursor 会自动调用 brave_web_search 拉取结果，再结合代码库给出迁移建议。

场景 2：让 Claude Code 写"今日新闻摘要"脚本

帮我写一个 Python 脚本：调用 brave_news_search 工具搜索「AI Agent」关键词，
把结果按时间倒序输出为 Markdown 文件。

Claude Code 会通过 MCP 调用搜索接口并把结果写入文件。

场景 3：本地商家查询

用 brave_local_search 查找北京海淀区 5 公里内的咖啡馆，按评分排序

返回包含店名、地址、评分、营业时间等结构化数据。

与同类方案对比

方案	索引来源	免费额度	MCP 官方支持	隐私
Brave Search MCP	Brave 自建	2000/月	✅	高
Tavily MCP	多源聚合	1000/月	✅	中
SerpAPI	Google/Bing	100/月	❌（需自封装）	中
自建爬虫 + Google	Google	易被封	❌	低

注意事项

API Key 保密：不要把 BRAVE_API_KEY 提交到 Git，建议用 .env 或系统密钥链管理。
频率限制：免费版 1 次/秒，超出会返回 429，需在客户端做重试退避。
中文搜索质量：Brave 对中文长尾查询不如百度，但对英文技术内容覆盖更好。建议中英文混合查询。
结果时效性：brave_news_search 默认返回 7 天内新闻，需更长时段请改用 brave_web_search + freshness=pm_7d 参数。
图片搜索合规：返回的图片 URL 受版权保护，商用前需确认授权。
MCP 协议版本：本服务器要求 MCP 协议 ≥ 2024-11-05，老版本客户端需升级。

小结

Brave Search MCP 是目前最省事的 LLM 联网方案：一行 npx、一个 API Key，就能让任意 MCP 客户端获得实时搜索能力。对于需要"查最新资讯、对比版本、获取官方文档"的 AI 编程与 AI 助理场景，几乎是必装组件。建议搭配 Filesystem MCP（管理本地文件）和 GitHub MCP（查仓库代码）组成最小三件套。

Brave Search MCP：让 LLM 联网搜索的开箱即用方案

简介

安装命令

简介