mcp-server-browserbase

Playwright Browserbase MCP 服务器

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

如何在 MCP json 中设置

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

在 NPM 上运行（推荐）

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

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

要 100% 本地运行：

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

标准输出：

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

上交所：

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

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

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

标志说明：

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

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

笔记：

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

标志和示例配置

代理

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

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

先进的隐身技术

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

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

上下文

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

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

Cookie注入

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

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

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

浏览器视口大小

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

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

结构

• 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、身份验证和缓存数据：

1. 创建上下文：
   browserbase_context_create: Creates a new context, optionally with a friendly name
2. 使用带有会话的上下文：
   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)
3. 删除上下文：
   browserbase_context_delete: Deletes a context when you no longer need it

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

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

Cookie 管理

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

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

这些工具可用于：

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

TODO/路线图

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