Playwright Browserbase MCP 服务器

模型上下文协议 (MCP) 是一种开放协议，支持 LLM 应用程序与外部数据源和工具之间的无缝集成。无论您是构建 AI 驱动的 IDE、增强聊天界面，还是创建自定义 AI 工作流，MCP 都提供了一种标准化的方式，将 LLM 与其所需的上下文连接起来。

如何在 MCP json 中设置

您可以使用我们在 NPM 上托管的服务器，也可以通过克隆此 repo 在本地完全运行它。

在 NPM 上运行（推荐）

进入您的 MCP 配置 JSON 并添加 Browserbase 服务器：

{ "mcpServers": { "browserbase": { "command": "npx", "args" : ["@browserbasehq/mcp"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

就这样！重新加载你的 MCP 客户端，Claude 就能使用 Browserbase 了。

要 100% 本地运行：

# Clone the Repo git clone https://github.com/browserbase/mcp-server-browserbase.git # Install the dependencies in the proper directory and build the project cd browserbase npm install && npm run build

然后在您的 MCP 配置 JSON 中运行服务器。要在本地运行，我们可以使用 STDIO 或通过 SSE 自托管。

标准输出：

在您的 MCP 配置 JSON 文件中添加以下内容：

{ "mcpServers": { "browserbase": { "command" : "node", "args" : ["/path/to/mcp-server-browserbase/browserbase/cli.js"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

上交所：

在终端中运行以下命令。您可以添加任何您认为合适的标志（请参阅下面的选项）来自定义您的配置。

node cli.js --port 8931

然后在您的 MCP 配置 JSON 文件中输入以下内容：

{ "mcpServers": { "browserbase": { "url": "http://localhost:8931/sse", "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

然后重新加载您的 MCP 客户端，您就可以开始了！

Related MCP server: Puppeteer MCP Server

标志说明：

Browserbase MCP 服务器接受以下命令行标志：

旗帜	描述
`--browserbaseApiKey <key>`	用于身份验证的 Browserbase API 密钥
`--browserbaseProjectId <id>`	您的 Browserbase 项目 ID
`--proxies`	为会话启用 Browserbase 代理
`--advancedStealth`	启用 Browserbase Advanced Stealth（仅适用于 Scale Plan 用户）
`--contextId <contextId>`	指定要使用的 Browserbase Context ID
`--persist [boolean]`	是否保留 Browserbase 上下文（默认值：true）
`--port <port>`	监听 HTTP/SSE 传输的端口
`--host <host>`	将服务器绑定到的主机（默认值：localhost，所有接口使用 0.0.0.0）
`--cookies [json]`	注入浏览器的 Cookie JSON 数组
`--browserWidth <width>`	浏览器视口宽度（默认值：1024）
`--browserHeight <height>`	浏览器视口高度（默认值：768）

这些标志可以直接传递给 CLI 或在 MCP 配置文件中进行配置。

笔记：

目前，这些标志只能与本地服务器（npx @browserbasehq/mcp）一起使用。

标志和示例配置

代理

这是我们关于代理的文档。

要在 STDIO 中使用代理，请在 MCP 配置中设置 --proxies 标志：

{ "mcpServers": { "browserbase": { "command" : "npx", "args" : ["@browserbasehq/mcp", "--proxies"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

先进的隐身技术

这是我们关于Advanced Stealth的文档。

要在 STDIO 中使用代理，请在 MCP 配置中设置 --advancedStealth 标志：

{ "mcpServers": { "browserbase": { "command" : "npx", "args" : ["@browserbasehq/mcp", "--advancedStealth"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

上下文

以下是我们关于上下文的文档

要在 STDIO 中使用上下文，请在 MCP 配置中设置 --contextId 标志：

{ "mcpServers": { "browserbase": { "command" : "npx", "args" : ["@browserbasehq/mcp", "--contextId", "<YOUR_CONTEXT_ID>"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

Cookie注入

为什么需要注入 Cookie？我们的上下文 API 目前适用于持久性 Cookie，但不支持会话 Cookie。因此，有时我们的持久性身份验证可能无法正常工作（我们正在努力添加此功能）。

您可以通过将 cookies.json 添加到您的 MCP 配置中来将 cookie 标记到 MCP 中。

要在 STDIO 中使用代理，请在 MCP 配置中设置 --proxies 标志。您的 Cookie JSON 必须为Playwright Cookies类型

{ "mcpServers": { "browserbase" { "command" : "npx", "args" : [ "@browserbasehq/mcp", "--cookies", '{ "cookies": json, }' ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

浏览器视口大小

浏览器会话的默认视口大小为 1024 x 768。您可以使用 browserWidth 和 browserHeight 标志调整浏览器视口大小。

以下是如何使用它来自定义浏览器尺寸。我们建议坚持使用 16:9 的宽高比（例如：1920 x 1080、1280、720、1024 x 768）。

{ "mcpServers": { "browserbase": { "command" : "npx", "args" : [ "@browserbasehq/mcp", "--browserHeight 1080", "--browserWidth 1920", ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } } }

结构

src/ ：TypeScript 源代码
- index.ts ：主入口点，环境检查，关闭
- server.ts ：MCP 服务器设置和请求路由
- sessionManager.ts ：处理浏览器会话创建/管理
- tools/ ：工具定义和实现
- resources/ ：资源（截图）处理
- types.ts ：共享 TypeScript 类型
dist/ ：编译后的 JavaScript 输出
tests/ ：测试的占位符
utils/ ：实用程序脚本的占位符
Dockerfile ：用于构建 Docker 镜像
配置文件（ .json 、 .ts 、 .mjs 、 .npmignore ）

持久化上下文

该服务器支持 Browserbase 的 Contexts 功能，该功能允许跨浏览器会话保留 cookie、身份验证和缓存数据：

创建上下文：
browserbase_context_create: Creates a new context, optionally with a friendly name
使用带有会话的上下文：
browserbase_session_create: Now accepts a 'context' parameter with: - id: The context ID to use - name: Alternative to ID, the friendly name of the context - persist: Whether to save changes (cookies, cache) back to the context (default: true)
删除上下文：
browserbase_context_delete: Deletes a context when you no longer need it

上下文使得以下操作变得更容易：

跨会话维护登录状态
通过保留缓存来减少页面加载时间
通过重复使用浏览器指纹来避免验证码和检测

Cookie 管理

该服务器还提供直接 cookie 管理功能：

添加 Cookies ：
browserbase_cookies_add: Add cookies to the current browser session with full control over properties
获取Cookies ：
browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)
删除Cookies ：
browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

这些工具可用于：

无需导航至登录页面即可设置身份验证 Cookie
备份和恢复 cookie 状态
调试与 Cookie 相关的问题
操作 cookie 属性（过期时间、安全标志等）

TODO/路线图

为点击、键入、拖动、悬停、选择选项实现真正的基于ref的交互逻辑。
使用ref实现特定元素的屏幕截图。
添加更多标准 MCP 工具（选项卡、导航等）。
添加测试。

mcp-server-browserbase