← MCP

Browserbase MCP ServerBrowserbase MCP Server

Browserbase

MCPMCP 浏览器自动化Browser automation 云端浏览器Cloud browser StagehandStagehand 远程托管Remote-hosted 仓已归档Archived repo partial lifecycle: active 核验Checked 2026-10-31

Browserbase 官方 MCP server：云端浏览器 + Stagehand 自然语言网页驱动，6 工具（start/end/navigate/act/observe/extract）。本档案的核心两口径：GitHub 自托管仓已 archived （README 顶部明写「仅存档、不代表现役实现」）——现役是托管线 mcp.browserbase.com/mcp，产品本身活跃（docs 在册、npm 3.0.0、底座 Stagehand 25,883★ 推送 2026-10-30）。自托管线只是「server 进程在你机器上」，浏览器会话仍在 Browserbase 云端、API key 照要。

Browserbase official MCP server: cloud browser + Stagehand natural-language page driving, 6 tools (start/end/navigate/act/observe/extract). The core two-wording of this dossier: the GitHub self-hosted repo is archived (the README top states plainly it is archival-only, not representative of the current implementation) — the current line is the hosted mcp.browserbase.com/mcp, and the product itself is active (docs live, npm 3.0.0, underlying Stagehand 25,883★ pushed 2026-10-30). Self-hosting only means "the server process is on your machine"; the browser session still lives on Browserbase cloud and the API key is still required.

适合与不适合When to use it, when not to

适合：要云端浏览器免本地环境、自然语言 act/observe/extract 三件套、托管省事（厂商包 Gemini 成本）。不适合：要开源可审计完整实现（现役实现闭源在托管侧）；只要本地浏览器自动化（Playwright MCP 更直接）。

Fits: cloud browser without local setup, natural-language act/observe/extract, hosted convenience (the vendor covers Gemini costs). Not a fit: wanting an open-source auditable full implementation (the current implementation is closed on the hosted side); local-only browser automation (Playwright MCP is more direct).

中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-31

出品属地Origin: 国外出品foreign-made　Browserbase, Inc.（美国，云端浏览器基础设施厂商）。Browserbase, Inc. (US, cloud browser infrastructure vendor).
国内使用Direct access: 大陆可直连direct OK　browserbase.com 与 docs.browserbase.com 直连 200；mcp.browserbase.com/mcp 直连 400（端点存在需鉴权）；GitHub 仓与 raw README 直连可达（2026-10-31）。browserbase.com and docs.browserbase.com returned 200 direct; mcp.browserbase.com/mcp returned 400 direct (endpoint exists, auth required); the GitHub repo and raw README were reachable direct (2026-10-31).
备案状态CAC filing: 未见于备案名单not in filing list：未见于网信办公示名单（2026-10-31 检索）；该产品未面向大陆公众提供服务，备案不适用。not in the CAC public registry (searched 2026-10-31); 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: 它自己需要外部模型跑 Stagehand——托管线由 Browserbase 侧提供 Gemini 的 LLM 成本（官方 README 明写 hosted 版「provide the LLM costs for Gemini」）；自托管线要自备 GEMINI_API_KEY（可 --modelName 换其他模型并配对应 key）。它是「浏览器自动化 + 模型」的混合体，不是纯接口包装。
It needs an external model to run Stagehand — on the hosted line Browserbase itself covers the LLM costs for Gemini (the official README states the hosted version "provides the LLM costs for Gemini"); the self-hosted line requires your own GEMINI_API_KEY (switch models with --modelName plus the matching key). It is a browser-automation-plus-model hybrid, not a pure interface wrapper.
运行位置Where it runs: 现役主推官方托管远程 server（https://mcp.browserbase.com/mcp，streamable-http）；自托管线走 npm（@browserbasehq/mcp 3.0.0，2026-03-31）或克隆 GitHub 仓。 GitHub 仓 browserbase/mcp-server-browserbase 已 archived（API 核验 archived=true， 3,397★，推送停 2026-07-20）——README 顶部明写「不再维护、仅存档、不代表现役生产实现」；底座 Stagehand 仓仍活跃（MIT 25,883★，推送 2026-10-30）。
The current flagship is the official hosted remote server (https://mcp.browserbase.com/mcp, streamable-http); the self-hosted line goes through npm (@browserbasehq/mcp 3.0.0, 2026-03-31) or cloning the GitHub repo. The GitHub repo browserbase/mcp-server-browserbase is archived (API-verified archived=true, 3,397★, last push 2026-07-20) — the README top states plainly it is "no longer maintained, kept for historical purposes, not representative of current production services"; the underlying Stagehand repo remains active (MIT 25,883★, pushed 2026-10-30).
本地文件Local files: 不读写本机文件——产物是云端浏览器会话里的页面状态与抽取结果（文本/结构化数据）。自托管线跑在你自己的机器上，但浏览器本身仍是 Browserbase 云端会话（要 BROWSERBASE_API_KEY）。
Reads and writes no local files — the artifacts are page state and extraction results (text/structured data) inside a cloud browser session. The self-hosted line runs on your machine, but the browser itself is still a Browserbase cloud session (BROWSERBASE_API_KEY required).
关机后的任务Tasks after shutdown: 浏览器会话活在 Browserbase 云端（start 创建/复用会话、end 关闭）；无本机后台进程。会话生命周期由工具调用显式管理，不是常驻。
The browser session lives on Browserbase's cloud (start creates/reuses a session, end closes it); no local background process. The session lifecycle is managed explicitly by tool calls, not persistent.
工具与扩展Tools & extensions: 6 个工具（README 口径，托管与自托管同工具集）：start（创建/复用会话）/ end（关闭会话）/ navigate（导航到 URL）/ act（按自然语言指令对页面动手）/ observe（观察可操作元素）/ extract（按指令抽取页面数据）。act/observe/extract 三件套由 Stagehand 的 act-and-observe 范式驱动。
6 tools (README wording; hosted and self-hosted share the same set): start (create/reuse a session) / end (close the session) / navigate (go to a URL) / act (manipulate the page from a natural-language instruction) / observe (observe actionable elements) / extract (extract page data per instruction). The act/observe/extract trio is driven by Stagehand's act-and-observe paradigm.
上下文与记忆Context & memory: 无 server 侧跨会话记忆；上下文=当前 Browserbase 浏览器会话（start 可复用既有会话）。会话内页面状态自然连续，跨会话不保。
No server-side cross-session memory; the context is the current Browserbase browser session (start can reuse an existing one). In-session page state is naturally continuous; nothing persists across sessions.
权限与限制Permissions & limits: 托管线要 Browserbase 账户（API key + project id，配在客户端）；自托管线要 BROWSERBASE_API_KEY/BROWSERBASE_PROJECT_ID/GEMINI_API_KEY 三个环境变量。 act 能在真实网页上动手（点击/填表）——授权边界按目标站点把关；云端会话内容在 Browserbase 侧留存，敏感流程要自己评估。
The hosted line needs a Browserbase account (API key + project id, configured in the client); the self-hosted line needs the BROWSERBASE_API_KEY/BROWSERBASE_PROJECT_ID/GEMINI_API_KEY environment variables. act manipulates real web pages (clicks/form filling) — gate the authorization boundary per target site; cloud session content is retained on Browserbase's side, so sensitive flows need your own assessment.
适合什么任务Best for: 适合：要「云端浏览器 + 自然语言驱动网页」的 agent（无需本地起浏览器）；要托管起步、 LLM 成本由厂商包的省事路线。不适合：要开源可审计的完整实现（GitHub 仓已 archived，现役实现闭源在托管侧）；只要本地浏览器自动化的场景（Playwright MCP 更直接）。
Fits: agents wanting "cloud browser + natural-language web driving" (no local browser to set up); the hosted line for easy onboarding with the vendor covering LLM costs. Not a fit: wanting an open-source auditable full implementation (the GitHub repo is archived; the current implementation is closed on the hosted side); scenarios that only need local browser automation (Playwright MCP is more direct).
传输方式Transport: streamable-http（托管 https://mcp.browserbase.com/mcp，官方推荐）+ stdio （npx @browserbasehq/mcp 自托管）；README 明写支持 STDIO 与 SHTTP 两种传输，推荐 SHTTP 走托管线。核验：仓 README（2026-10-31 经 GitHub API raw 直抓）+ docs.browserbase.com MCP 页（直连 200）。
streamable-http (hosted https://mcp.browserbase.com/mcp, officially recommended) + stdio (npx @browserbasehq/mcp self-hosted); the README states both STDIO and SHTTP transports are supported, recommending SHTTP via the hosted line. Verified: repo README (fetched via GitHub API raw 2026-10-31) + the docs.browserbase.com MCP page (200 direct).
认证机制Authentication: Browserbase 账户凭据（BROWSERBASE_API_KEY + BROWSERBASE_PROJECT_ID）；自托管线另加模型 key （默认 GEMINI_API_KEY）。托管端点直连实测 400（存在、需正确 MCP 握手与鉴权，非死链）。
Browserbase account credentials (BROWSERBASE_API_KEY + BROWSERBASE_PROJECT_ID); the self-hosted line adds a model key (GEMINI_API_KEY by default). The hosted endpoint measured 400 direct (exists, requires a proper MCP handshake and auth — not a dead link).
权限范围Permission scope: 读面（navigate/observe/extract）+ 网页写面（act 点击填表）；无本机文件写面。云端浏览器会话可带登录态——「在网页上动手」的边界按目标站点授权把关。
Read surface (navigate/observe/extract) + web write surface (act clicks and fills forms); no local file write surface. Cloud browser sessions can carry login state — gate the "touching things on a web page" boundary per the target site's authorization.

头号误解Top misconception

把 GitHub 仓当现役实现——仓已 archived（README 顶部明写），官方推荐托管线 mcp.browserbase.com/mcp；「仓 archived ≠ 产品停运」是本档案的核心两口径Treating the GitHub repo as the current implementation — the repo is archived (stated plainly at the README top); the official recommendation is the hosted line mcp.browserbase.com/mcp; "repo archived != product discontinued" is this dossier's core two-wording
以为自托管不需要 Browserbase 账户——自托管只是 server 进程在你机器上，浏览器会话仍在 Browserbase 云端，API key 照要Thinking self-hosting needs no Browserbase account — self-hosting only puts the server process on your machine; the browser session still lives on Browserbase cloud and the API key is still required
以为它完全不需要模型 key——自托管线要自备 GEMINI_API_KEY（或换模型配对应 key），托管线才由厂商包 Gemini 成本Thinking it needs no model key at all — the self-hosted line requires your own GEMINI_API_KEY (or a swapped model with its key); only the hosted line has the vendor covering Gemini costs
把 act 当安全动作——它能在真实网页点击填表，登录态与写操作风险按目标站点把关Treating act as a safe action — it clicks and fills forms on real web pages; login-state and write-operation risks are gated per target site

未知项清单Known unknowns

托管线的速率/会话时长/并发配额（docs 有账户档位口径，未逐条清点；按 D9 与快照纪律不记数字）
自托管线换模型（--modelName）支持的模型清单与各家 key 要求（README 只给机制）
云端会话内容在 Browserbase 侧的留存时长与合规边界（ToS 面未逐条核验）

Rate/session-duration/concurrency quotas on the hosted line (the docs have account-tier wording, not enumerated item by item; per D9 and snapshot discipline no numbers are recorded)
The model list supported by the self-hosted line's --modelName switch and each provider's key requirements (the README gives only the mechanism)
Retention period and compliance boundaries of cloud session content on Browserbase's side (the ToS surface was not verified item by item)

证据来源Evidence sources

判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-31，内容更新日content updated on 2026-10-31。

类型Type	名称Name	链接Link
docs	Browserbase · 官方文档 MCP 集成页（托管端点与配置线；直连 200）Browserbase · official docs MCP integration page (hosted endpoint and configuration line; 200 direct)	https://docs.browserbase.com/integrations/mcp/introduction
repo	browserbase/mcp-server-browserbase · 仓库（archived=true；Apache-2.0；3,397★，推送停 2026-07-20，GitHub API 核验；README 顶部归档声明+6 工具表+托管推荐）browserbase/mcp-server-browserbase · repository (archived=true; Apache-2.0; 3,397★, last push 2026-07-20, GitHub API verified; README-top archive notice + 6-tool table + hosted recommendation)	https://github.com/browserbase/mcp-server-browserbase
changelog	GitHub commits · mcp-server-browserbase（仓归档前的变更记录线）GitHub commits · mcp-server-browserbase (change-record line before the repo was archived)	https://github.com/browserbase/mcp-server-browserbase/commits/main
changelog	npm · @browserbasehq/mcp（自托管发版线：3.0.0，2026-03-31）npm · @browserbasehq/mcp (self-hosted release line: 3.0.0, 2026-03-31)	https://www.npmjs.com/package/@browserbasehq/mcp

实测记录Measured runs

本档未在真实客户端逐项跑通；工具清单与权限来自官方 README。

This site has not completed measured runs. The test protocol is at protocols/mcp/_protocol.md.