Brave Search MCP Server

官方

通过 MCP 使用 Brave Search 的综合搜索能力

分类: 浏览器自动化第 8 / 32
Stars: ★ 1.5k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 21 天前
工具数: 8

59FMRS · C

这是由 Brave 维护的官方搜索 MCP Server，工具覆盖网页、新闻、图片、视频、本地搜索、地点搜索、LLM 上下文和摘要。它需要 Brave Search API key；默认 STDIO，HTTP 模式应特别注意未认证端点的网络暴露风险。

最强项 · 文档质量 15/20 最弱项 · 维护活跃度 7/20

可靠性

9/20

安全与权限

14/20

维护活跃度

7/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: 清单提供了可复现的 npm 包、版本、stdio 传输和必需密钥，README 也描述了构建及工具参数，因此正常启动和握手是合理可行的。但提供的材料没有源代码、CI、测试或错误路径证据，无法验证 MCP 初始化、工具列表与实际实现的一致性；README 还描述 HTTP 等额外模式而清单仅声明 stdio，故保守扣分。
安全与权限 14/20: API 密钥被声明为必需秘密，并支持从文件读取；默认 HTTP 绑定回环地址，并记录了未认证端点、Origin 防 DNS 重绑定及可选 Host 校验等边界。服务器主要执行外部搜索，无删除、支付或部署副作用。但 HTTP 暴露时仍未提供身份认证，Host 校验默认关闭，且搜索请求和位置标头会发送至 Brave；缺少更完整的权限隔离和数据保留说明，因此扣分。
维护活跃度 7/20: 材料显示项目未归档，且有明确的 2.1.0 版本和 MIT 许可证，说明存在基本发布与许可信息。但没有提交历史、CI、依赖更新、维护者响应、漏洞报告或安全响应渠道证据，无法证明持续维护或明确治理，因此仅给中低分。
文档质量 15/20: README 覆盖了安装、API 密钥、传输配置、多个工具及参数范围、环境变量、客户端示例、构建和 Docker 使用，也披露了部分 Pro 计划限制及 HTTP 安全注意事项。缺少明确价格、配额和速率限制、系统化故障排查、测试证据及实现级行为验证；清单与 README 对传输范围的表达也不完全一致，因此扣分。
安装易用性 14/20: 提供 npm、Docker、Claude Desktop 和 VS Code 配置示例，包含密钥输入、默认 stdio、Node.js 要求及构建步骤，主流客户端接入路径清晰。仍需准备 Brave 账户和 API 密钥，部分场景需手动构建或配置 HTTP，且没有文件级执行验证、跨平台验证或自动化测试证据，因此未给满分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要 Brave Search API 数据的 AI Agent
需要网页检索、新闻检索或多媒体搜索的工作流
需要地点和本地商家结构化信息的应用

不适合谁

不需要外部搜索服务的离线工作流
无法提供 Brave Search API key 的环境
需要完整本地搜索能力但没有 Pro 计划的用户

所需权限

需要有效的 BRAVE_API_KEY；也可通过 BRAVE_API_KEY_FILE 从文件读取密钥
需要访问 Brave Search API 的网络连接
使用 HTTP 模式时，端口和主机绑定由配置决定

风险与副作用

API key 是必需的秘密凭据，应避免暴露在日志或配置共享中
HTTP 端点未认证；若绑定到非回环地址，应仅在可信网络中使用
本地搜索的完整能力以及部分额外摘要功能需要 Pro 计划
搜索结果和 AI 摘要依赖外部服务，内容可能不完整或需要进一步核验

安装接入

准备工作

运行环境：Node.js 22+ · Docker

BRAVE_API_KEY 必填密钥 Brave Search API 密钥，从 https://api-dashboard.search.brave.com/app/keys 开发者面板生成；BRAVE_API_KEY_FILE

BRAVE_API_KEY_FILE 可选密钥

其他可选配置项（9 个）

BRAVE_MCP_TRANSPORT 可选

BRAVE_MCP_PORT 可选

BRAVE_MCP_HOST 可选

BRAVE_MCP_ALLOWED_ORIGINS 可选

BRAVE_MCP_ALLOWED_HOSTS 可选

BRAVE_MCP_LOG_LEVEL 可选

BRAVE_MCP_ENABLED_TOOLS 可选

BRAVE_MCP_DISABLED_TOOLS 可选

BRAVE_MCP_STATELESS 可选

先注册 Brave Search API 账户并生成 API key。使用 npm 包安装时，将示例配置加入 Claude Desktop 或 VS Code，并设置 BRAVE_API_KEY。服务器默认使用 STDIO；如需 HTTP，可设置 BRAVE_MCP_TRANSPORT=http 或传入 --transport http。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server",
        "--transport",
        "stdio"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add brave-search -e BRAVE_API_KEY=YOUR_API_KEY_HERE -- npx -y @brave/brave-search-mcp-server --transport stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 brave_web_search 等八个 brave_* 工具；让客户端执行一次网络搜索并返回结果，能返回真实搜索结果即证明安装和 API key 配置成功。

常见排障

确认 BRAVE_API_KEY 已设置，或确认 BRAVE_API_KEY_FILE 指向容器或运行环境内存在的密钥文件
检查 npm 包版本、Node.js 22.x 或更高版本以及构建是否成功
确认客户端配置使用正确的 npx 包名和 STDIO 参数
HTTP 模式下检查 BRAVE_MCP_TRANSPORT、BRAVE_MCP_HOST、BRAVE_MCP_PORT 以及允许的 Origin 或 Host 设置
使用 brave_summarizer 前，先在 brave_web_search 中启用 summary=true 并取得 summary key

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 brave_web_search 搜索最新的量子计算新闻并总结要点
帮我找一下旧金山附近评分最高的咖啡店，用 brave_local_search
用 brave_image_search 搜索北极光的高清图片
用 brave_summarizer 根据我刚才搜索得到的 summary key 生成一段 AI 摘要

工具能力 8

brave_web_search 只读

执行带有丰富结果类型和高级筛选选项的网页搜索。

brave_local_search 只读

搜索本地商家和地点，并返回评分、营业时间及 AI 生成的描述。

brave_video_search 只读

搜索视频并返回元数据和缩略图信息。

brave_image_search 只读

搜索图片并返回 URL、尺寸和置信度等元数据。

brave_news_search 只读

搜索新闻文章，支持时间新鲜度筛选和突发新闻标记。

brave_summarizer 只读

根据网页搜索结果，通过 Brave 摘要 API 生成 AI 摘要。

brave_place_search 只读

按地理区域搜索兴趣点，并返回地址、营业时间、联系方式、评分、照片、类别和时区等结构化信息。

brave_llm_context 只读

获取为 AI Agent、LLM grounding 和 RAG 流程优化的预提取网页内容。

使用场景

检索网页资料并获取结构化搜索结果

搜索新闻、图片、视频、本地商家和地点

为 AI Agent 或 RAG 流程获取网页上下文

先执行带 summary=true 的网页搜索，再生成 AI 摘要

支持客户端

Claude Desktop

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Brave Search MCP Server 将 Brave Search API 接入 MCP，提供网页、本地商家、地点、图片、视频和新闻搜索，以及面向 AI 的网页上下文和摘要功能。默认使用 STDIO，也支持 HTTP。