📘 mcp-server-browserbase
← 返回首页

Browserbase MCP 服务器

smithery badge

cover

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

该服务器利用 Browserbase 和 Stagehand 提供云浏览器自动化能力。它使 LLM 能够与网页交互、截图、提取信息并以原子级精度执行自动化操作。

Stagehand v3 的新特性

基于 Stagehand v3.0，此 MCP 服务器现在包含：

  • 性能提升 20-40%：通过自动缓存，所有核心操作（act、extract、observe）的速度均得到提升
  • 增强的提取功能：跨 iframe 和 shadow root 的定向提取和观察
  • 改进的模式：简化的提取模式，使数据提取更直观
  • 高级选择器支持：CSS 选择器支持，改进了元素定位
  • 多浏览器支持：兼容 Playwright、Puppeteer 和 Patchright
  • 新原语：内置 page、locator、frameLocator 和 deepLocator，简化自动化流程
  • 实验性功能：通过 --experimental 标志启用前沿功能

更多详情，请访问 Stagehand v3 文档。

功能特性

功能特性 描述
浏览器自动化 通过 Browserbase 控制和编排云浏览器
数据提取 从任何网页提取结构化数据
网页交互 轻松导航、点击和填写表单
截图 捕获整页和元素截图
模型灵活性 支持多种模型（OpenAI、Claude、Gemini 等）
视觉支持 对复杂 DOM 使用带标注的截图
会话管理 创建、管理和关闭浏览器会话
高性能 通过自动缓存，操作速度提升 20-40%（v3）
高级选择器 增强的 CSS 选择器支持，实现精确的元素定位

如何设置

快速开始：

添加到 Cursor

在浏览器中复制并粘贴此链接：

cursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19

我们目前为 MCP 服务器支持 2 种传输方式：STDIO 和 SHTTP。我们建议您使用 SHTTP 配合我们远程托管的 URL，以充分利用服务器的全部能力。

SHTTP：

要通过我们远程托管的 URL 使用 Browserbase MCP 服务器，请将以下内容添加到您的配置中。

访问 smithery.ai 并输入您的 API 密钥和配置以获取远程托管 URL。 使用我们的远程托管服务器时，我们提供 Gemini（Stagehand 中性能最佳的模型）的 LLM 成本。

Smithery Image

如果您的客户端支持 SHTTP：

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "your-smithery-url.com"
    }
  }
}

如果您的客户端不支持 SHTTP：

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "your-smithery-url.com"]
    }
  }
}

STDIO：

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

❗️ 重要提示： 如果您想使用不同的模型，必须在 args 中添加 --modelName 并提供相应的密钥作为参数。更多信息见下文。

在 NPM 上运行（推荐）

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

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

就是这样！重新加载您的 MCP 客户端，Claude 将能够使用 Browserbase。

100% 本地运行：

选项 1：直接安装

# 克隆仓库
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase

# 安装依赖并构建项目
npm install && npm run build

选项 2：Docker

# 克隆仓库
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase

# 构建 Docker 镜像
docker build -t mcp-browserbase .

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

STDIO：

使用直接安装

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

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

使用 Docker

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

{
  "mcpServers": {
    "browserbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BROWSERBASE_API_KEY",
        "-e",
        "BROWSERBASE_PROJECT_ID",
        "-e",
        "GEMINI_API_KEY",
        "mcp-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

然后重新加载您的 MCP 客户端，您应该就可以使用了！

配置

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

标志 描述
--proxies 为会话启用 Browserbase 代理
--advancedStealth 启用 Browserbase 高级隐身模式（仅限 Scale 计划用户）
--keepAlive 启用 Browserbase 会话保持活动状态
--contextId <contextId> 指定要使用的 Browserbase 上下文 ID
--persist 是否持久化 Browserbase 上下文（默认：true）
--port <port> HTTP/SHTTP 传输监听的端口
--host <host> 服务器绑定的主机（默认：localhost，使用 0.0.0.0 表示所有接口）
--browserWidth <width> 浏览器视口宽度（默认：1024）
--browserHeight <height> 浏览器视口高度（默认：768）
--modelName <model> Stagehand 使用的模型（默认：gemini-2.0-flash）
--modelApiKey <key> 自定义模型提供商的 API 密钥（使用自定义模型时需要）
--experimental 启用实验性功能（默认：false）

这些标志可以直接传递给 CLI，也可以在您的 MCP 配置文件中配置。

注意：

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

在 Docker 中使用配置标志

使用 Docker 时，您可以在镜像名称后传递配置标志作为附加参数。以下是使用 --proxies 标志的示例：

{
  "mcpServers": {
    "browserbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BROWSERBASE_API_KEY",
        "-e",
        "BROWSERBASE_PROJECT_ID",
        "-e",
        "GEMINI_API_KEY",
        "mcp-browserbase",
        "--proxies"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

您也可以直接从命令行运行 Docker 容器：

docker run --rm -i \
  -e BROWSERBASE_API_KEY=your_api_key \
  -e BROWSERBASE_PROJECT_ID=your_project_id \
  -e GEMINI_API_KEY=your_gemini_key \
  mcp-browserbase --proxies

配置示例

代理

这是关于代理的文档。

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

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

高级隐身模式

这是关于高级隐身模式的文档。

要使用高级隐身模式，请在您的 MCP 配置中设置 --advancedStealth 标志：

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

上下文

这是关于上下文的文档。

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

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

浏览器视口尺寸

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

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

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

实验性功能

Stagehand v3 包含可通过 --experimental 标志启用的实验性功能。这些功能提供了正在积极开发和优化的前沿能力。

要启用实验性功能：

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

注意：实验性功能可能在未来的版本中更改或移除。请自行斟酌使用。

模型配置

Stagehand 默认使用 Google 的 Gemini 2.0 Flash 模型，但您可以将其配置为使用其他模型，如 GPT-4o、Claude 或其他提供商。

重要提示：当使用任何自定义模型（非默认）时，您必须使用 --modelApiKey 标志提供该模型提供商的自己的 API 密钥。

以下是配置不同模型的方法：

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp-server-browserbase",
        "--modelName",
        "anthropic/claude-sonnet-4.5",
        "--modelApiKey",
        "your-anthropic-api-key"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": ""
      }
    }
  }
}

注意：模型必须在 Stagehand 中得到支持。请查看此处的文档。当使用任何自定义模型时，您必须提供该提供商的自己的 API 密钥。

资源

服务器提供对截图资源的访问：

  1. 截图 (screenshot://<screenshot-name>)
    • 捕获截图的 PNG 图像

主要特性

  • AI 驱动的自动化：用于网页交互的自然语言命令
  • 多模型支持：适用于 OpenAI、Claude、Gemini 等
  • 截图捕获：整页和特定元素的截图
  • 数据提取：从网页智能提取内容
  • 代理支持：企业级代理能力
  • 隐身模式：高级反检测功能
  • 上下文持久化：跨会话保持身份验证和状态

有关模型上下文协议的更多信息，请访问：

官方 MCP 文档：

许可证

根据 Apache 2.0 许可证授权。

版权所有 2025 Browserbase, Inc.

原文地址 https://github.com/browserbase/mcp-server-browserbase