简介
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 | 易被封 | ❌ | 低 |
注意事项
- 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（查仓库代码）组成最小三件套。