/ 目录 / 演练场 / Brave Search
● 官方 brave 🔑 需要你的密钥

Brave Search

作者 brave · modelcontextprotocol/servers

尊重隐私的网页、新闻和图片搜索——独立索引,非 Google。免费版本满足大多数个人需求。

Brave Search MCP 的参考实现。包装了 Brave Search API:网页、本地、新闻、视频和图片搜索。Brave 运营独立索引(非 Bing/Google 转售),提供隐私保证和合理的免费配额。

为什么要用

核心特性

实时演示

实际使用效果

brave-search.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "brave-search",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "brave-search": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-brave-search"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Brave Search

用多个独立来源验证声明

👤 作家、研究人员、任何警惕 AI 幻觉的人 ⏱ ~5 min beginner

何时使用: 你有一个声明('X 公司有 Y 名员工'),需要 2-3 个引用,而不是 Claude 从训练数据中记得的内容。

前置条件
  • Brave Search API 密钥 — api.search.brave.com——免费版本 2k/月,无需信用卡
步骤
  1. 搜索声明
    在 Brave 搜索 'Acme Robotics employee count site:linkedin.com OR site:crunchbase.com'。前 5 个结果。✓ 已复制
    → 多个独立来源的组合
  2. 核对数字
    每个来源可能给出略微不同的数字。列出它们及其日期。哪个数字最值得引用?✓ 已复制
    → 每个来源的数字 + 合理的选择
  3. 格式化引用
    用内联引用写出声明。使用最新的、最权威的来源。✓ 已复制
    → 句子 + (来源,日期) 内联

结果: 一个有充分引用的声明,显示了工作过程。

注意事项
  • 单个搜索结果摘要不够——声明可能被曲解 — 对于关键声明,获取实际页面(fetch MCP)并在上下文中验证引用
搭配使用: fetch

获取特定主题的今日新闻

👤 任何想要最新新闻综合的人 ⏱ ~5 min beginner

何时使用: 你想要关于小众话题的新闻摘要,比 Claude 的训练截止日期更新。

步骤
  1. 新闻搜索
    Brave 新闻搜索:'EU AI Act enforcement',最近 7 天,前 10 个结果。✓ 已复制
    → 带有日期的最新新闻项
  2. 分组 + 总结
    按角度分组。用 1 句话总结每个分组。记下来源之间的任何冲突声明。✓ 已复制
    → 2-4 个主题集群,标记冲突
  3. 选择重要的
    如果我只有 5 分钟读其中一个,应该读哪个,为什么?✓ 已复制
    → 单个推荐及其原因

结果: 一个尊重你时间的时事简报。

注意事项
  • 同一条通讯社新闻被 20 个网站转载 = 虚假的共识感 — 让 Claude 通过导语相似性而不是仅 URL 来检测重复项

为现实任务查找本地企业

👤 任何计划出行或本地跑腿的人 ⏱ ~5 min beginner

何时使用: 你想要'最近的最好拉面'这样的答案,不用打开地图应用。

步骤
  1. 本地搜索
    Brave 本地搜索:在'Mission District, San Francisco'附近搜索'ramen'。前 10 个结果,包括地址和评分(如果有)。✓ 已复制
    → 真实企业及其地址
  2. 按你的喜好过滤
    我想要手拉面,不要连锁店。哪些符合?✓ 已复制
    → 带有理由的过滤列表
  3. 选出赢家
    选一个。告诉我地址、营业时间(如果知道),以及一个让它成为正确选择的细节。✓ 已复制
    → 果断的推荐

结果: 一个你可以采取行动的选择,无需浏览 Yelp。

注意事项
  • 本地数据的新鲜度各不相同——已关闭的企业可能仍会出现 — 对于高风险情况(要驾驶 30 分钟),通过企业自己的网站确认营业时间
搭配使用: google-maps

组合

与其他 MCP 搭配,撬动十倍杠杆

brave-search + fetch

搜索 → 获取最相关的 URL → 总结

在 Brave 搜索 'OWASP LLM top 10 2026'。获取第一个结果的完整内容并总结这 10 项。✓ 已复制
brave-search + memory

将搜索得出的事实保存为观察结果以供日后回忆

搜索我们前 5 大竞争对手的员工数。将每个作为观察结果存储在内存中的相应公司实体上。✓ 已复制
brave-search + google-maps

Brave 查找候选地点 → Google Maps 获取路线

通过 Brave 本地搜索在 Mission 找拉面店。对于前 3 个,通过 Google Maps 获取从 Mission/16th BART 的步行路线。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
brave_web_search query: str, count?: int (1-20), offset?: int 常规网页搜索 1 query against quota
brave_local_search query: str, count?: int 查找地点附近的企业、兴趣点 1 query

成本与限制

运行它的成本

API 配额
免费版本:2000 次查询/月,1 次查询/秒。付费计划价格更高。
每次调用 Token 数
每次响应约 500-2000 tokens,取决于结果数量
费用
个人使用免费;付费计划用于更高配额
提示
默认使用 count: 5。前 5 个结果通常是你需要的全部信号——付费获取 20 个结果很少值得。

安全

权限、密钥、影响范围

凭据存储: API 密钥在环境变量 BRAVE_API_KEY
数据出站: 查询发送到 api.search.brave.com;适用 Brave 的隐私政策

故障排查

常见错误与修复

401 Unauthorized

在 MCP 客户端环境中设置 BRAVE_API_KEY。在 api.search.brave.com 获取密钥。

429 Too Many Requests

免费版本限制为 1 次查询/秒。在批量工作流中的搜索之间添加限流。

配额已超出

达到了月度限制。等待重置或升级。

本地搜索返回空结果

本地索引在主要大都市外的覆盖范围有限。对于小众位置,回退到网页搜索。

替代方案

Brave Search 对比其他方案

替代方案何时用它替代权衡
Exa Search MCP你想要神经/语义搜索和完整页面内容不同的模型;更适合'为我找到类似 X 的东西'
Google's official Programmable Search (custom MCP)你需要 Google 特定的信号源设置复杂度高;大规模使用成本更高
DuckDuckGo via fetch你想要使用 duck 的无需密钥搜索没有结构化 API;需要 HTML 解析

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills