Brave Search MCP ServerBrave Search MCP Server
Brave 官方搜索 MCP server(MIT):给 agent 补一路独立检索源(web/新闻/图像/地点)。 一条归档事实:MCP 组织仓里的旧 Brave reference 已归档,官方 README 明写由 @brave 包接替—— 本条目就是现役那条。
Brave's official search MCP server (MIT): an independent retrieval source for agents (web/news/images/places). One archival fact: the old Brave reference in the MCP org repo was archived, and the official README says the @brave package replaces it — this profile is the live one.
适合与不适合When to use it, when not to
适合:要独立于模型内置搜索的检索面、纯读低风险接入。 不适合:要抓正文(fetch 线);零配置无 key 场景。
Fits: an independent retrieval lane besides built-in model search; low-risk read-only integration. Not a fit: deep content scraping (fetch line); zero-config no-key scenarios.
中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-21
- 出品属地Origin
- 国外出品foreign-made Brave Software, Inc.(美国)。Brave Software, Inc. (US).
- 国内使用Direct access
- 直连不可达direct blocked github.com 直连实测 000(波动,同日代理可达 200)。github.com measured 000 direct (fluctuating; 200 via proxy the same day).
- 备案状态CAC filing
- 未见于备案名单not in filing list:未见于网信办公示名单(2026-10-21 检索);该产品未面向大陆公众提供服务,备案不适用。not in the CAC public registry (searched 2026-10-21); the product does not serve the mainland public, so filing does not apply.
备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准(按批次滚动更新,本站只抄编号不解读);「大陆可直连」是本站从大陆网络直连实测的结果,不是厂商承诺。GitHub 类站点当日实测有波动,口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.
固定坐标系Fixed coordinate system
11 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.
- 模型与开放条件Model & openness
它自己不调模型——被 MCP 客户端调用的接口实现。它把 Brave Search API (web 搜索、新闻、图像、local 地点)包装成工具给 agent 用。
It calls no model itself — an interface implementation called by MCP clients. It wraps the Brave Search API (web search, news, images, local places) as tools for agents.
- 运行位置Where it runs
本地进程(npx stdio)+ 远程托管线(官方有 remote 端点说明);GitHub 1,544★, 最近推送 2026-10-27(API 核验)。
A local process (npx stdio) plus a remote-hosted line (the official docs describe a remote endpoint); GitHub 1,544★, last push 2026-10-27 (API verified).
- 本地文件Local files
不读写本机文件——它输出搜索结果文本/链接;抓取网页内容不在它范围(那是 fetch server 的活)。
Reads and writes no local files — it outputs search-result text/links; fetching page content is out of its scope (that is the fetch server's job).
- 关机后的任务Tasks after shutdown
stdio 随客户端生死;无后台任务语义。
stdio lives and dies with the client; no background-task semantics.
- 工具与扩展Tools & extensions
web_search / news_search / image_search / video_search / local_search 等按 API 族分组, 可按配置裁剪启用;完整清单以仓 README 为准。
web_search / news_search / image_search / video_search / local_search etc., grouped by API family, trimmable via configuration; the complete inventory follows the repo README.
- 上下文与记忆Context & memory
无跨会话记忆——每次搜索独立。
No cross-session memory — each search is independent.
- 权限与限制Permissions & limits
Brave Search API key(免费层/付费层按 Brave API 账户走);纯读面—— 它不能写任何系统,风险面主要是查询内容外发与配额消耗。
A Brave Search API key (free/paid tiers follow the Brave API account); a pure read surface — it cannot write to any system; the risk surface is mainly query egress and quota consumption.
- 适合什么任务Best for
适合:给 agent 补「现役搜索」能力(reference 的 Brave 版归档后,官方 @brave 包接替)、 要独立于大模型内置搜索的检索源。 不适合:要深度抓取正文(fetch/firecrawl 线);无 API key 的零配置场景。
Fits: giving an agent a "live search" capability (after the archived Brave reference in the MCP repo, the official @brave package took over), a retrieval source independent of the LLM's built-in search. Not a fit: deep content fetching (the fetch/firecrawl line); zero-configuration scenarios without an API key.
- 传输方式Transport
stdio(npx @brave/brave-search-mcp-server)为主;官方另有远程线说明——未逐条核验。 核验:仓 README(2026-10-21 直抓)。
stdio (npx @brave/brave-search-mcp-server) is primary; the official docs also describe a remote line — not verified item by item. Verified against: the repo README (direct-fetched 2026-10-21).
- 认证机制Authentication
BRAVE_API_KEY 环境变量;key 的配额/套餐层按 Brave API 账户(D9 不采价格)。
The BRAVE_API_KEY environment variable; the key's quota/plan tiers follow the Brave API account (prices not collected per our price-recording policy).
- 权限范围Permission scope
纯读:搜索族工具(web/news/image/video/local)。无写面;无审批需求。
Pure read: the search-family tools (web/news/image/video/local). No write surface; no approval needed.
头号误解Top misconception
- 用 modelcontextprotocol 仓里的旧 Brave reference——已归档,现役是官方 @brave/brave-search-mcp-server(官方 README 明写接替关系)Using the archived Brave reference in the modelcontextprotocol repo — it is archived; the live line is the official @brave/brave-search-mcp-server (the official README states the replacement)
- 把「搜索」当「抓取」——它返回结果摘要与链接,不抓正文Reading 'search' as 'scrape' — it returns result summaries and links, not page bodies
- API key 配额与计费层按 Brave 账户走——报价记录约定:本站不记价格数字Quota and billing follow the Brave API account — this site records no price figures (rule D9)
未知项清单Known unknowns
- 远程托管线当前状态(未逐条核验)
- 各搜索族工具的完整参数面(未逐条清点)
- The current status of the remote-hosted line (not verified item by item)
- The full parameter surface of each search-family tool (not enumerated item by item)
证据来源Evidence sources
判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-30,内容更新日content updated on 2026-10-21。
| 类型Type | 名称Name | 链接Link |
|---|---|---|
| repo | brave/brave-search-mcp-server · 仓库(MIT;1,544★,最近推送 2026-10-27,GitHub API 核验)brave/brave-search-mcp-server · repository (MIT; 1,544★, last push 2026-10-27, GitHub API verified) | https://github.com/brave/brave-search-mcp-server |
| changelog | brave/brave-search-mcp-server · Releases(changelog)brave/brave-search-mcp-server · Releases (changelog) | https://github.com/brave/brave-search-mcp-server/releases |
| docs | modelcontextprotocol/servers · README(官方归档说明:Brave 由 @brave 包接替)modelcontextprotocol/servers · README (official archival note: Brave taken over by the @brave package) | https://github.com/modelcontextprotocol/servers |
实测记录Measured runs
本档未在真实客户端逐项跑通;工具清单与权限来自官方 README。
This site has not completed measured runs. The test protocol is at protocols/mcp/_protocol.md.
相关条目Related entries
- Fetch MCP ServerFetch MCP Server检索↔抓取分工对照:Brave 给「找到哪页」,fetch 给「读这页正文」。The search↔fetch division-of-labour contrast: Brave tells you "which page", fetch gives you "this page's body text".
- CursorCursor另一层 · AI 编程Other layer · AI coding
- Claude Code IDE 扩展Claude Code (IDE extension)另一层 · AI 编程Other layer · AI coding
本页由This page is generated from the ai-handbook 数据层生成(CC BY 4.0)。data layer (CC BY 4.0).
方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.