ImRonAI-mcp-server-browserbase

Browserbase MCP Server

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

此服务使用 Browserbase 和 Stagehand 提供云端浏览器自动化功能。它能让大模型与网页交互、截取屏幕截图、提取信息，并以精准的原子化方式执行自动操作。

功能

功能	描述
浏览器自动化	通过 Browserbase 控制和编排云端浏览器
数据提取	从任意网页提取结构化数据
网页交互	轻松浏览网页、点击并填写表单
屏幕截图	截取整页和页面元素的屏幕截图
模型灵活性	支持多种模型（OpenAI、Claude、Gemini 等）
视觉支持	使用带注释的屏幕截图处理复杂的 DOM
会话管理	创建、管理和关闭浏览器会话
多会话	并行运行多个浏览器会话

设置方法

快速入门：

添加到 Cursor

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

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

目前，我们的 MCP 服务支持两种传输方式：STDIO 和 SHTTP。我们建议使用 SHTTP 和远程托管 URL，以充分发挥服务的性能。

SHTTP：

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

前往 smithery.ai，输入你的 API 密钥和配置，以获取远程托管 URL。 使用我们的远程托管服务时，我们会承担 Gemini 的大模型费用。Gemini 是 Stagehand 中表现最佳的模型。

如果你的客户端支持 SHTTP：

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

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

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

STDIO：

你可以使用托管在 NPM 上的服务，也可以克隆此仓库并完全在本地运行。

**❗️ 重要提示：**如果你想使用其他模型，必须在参数中添加 --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 了。

完全在本地运行：

# Clone the Repo
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase

# Install the dependencies and build the project
npm install && npm run build

然后在 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": ""
      }
    }
  }
}

然后重新加载 MCP 客户端，即可开始使用！

配置

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

标志	描述
--proxies	为会话启用 Browserbase 代理
--advancedStealth	启用 Browserbase Advanced Stealth（仅限 Scale Plan 用户）
--keepAlive	启用 Browserbase Keep Alive 会话
--contextId <contextId>	指定要使用的 Browserbase Context ID
--persist	是否持久化 Browserbase 上下文（默认值：true）
--port <port>	HTTP/SHTTP 传输的监听端口
--host <host>	要绑定的主机（默认值：localhost；使用 0.0.0.0 可绑定所有接口）
--cookies [json]	要注入浏览器的 Cookie JSON 数组
--browserWidth <width>	浏览器视口宽度（默认值：1024）
--browserHeight <height>	浏览器视口高度（默认值：768）
--modelName <model>	Stagehand 要使用的模型（默认值：google/gemini-2.0-flash）
--modelApiKey <key>	自定义模型提供商的 API 密钥（使用自定义模型时必填）
--experimental	启用实验性功能（默认值：false）

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

注意：

目前，这些标志只能用于本地服务（npx @browserbasehq/mcp-server-browserbase）。

配置示例

代理

请参阅我们的代理文档。

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

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

Advanced Stealth

请参阅我们的 Advanced Stealth 文档。

要使用 Advanced Stealth，请在 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 默认使用 Google 的 Gemini 2.0 Flash 模型，但你也可以将其配置为使用 GPT-4o、Claude 或其他提供商的模型。

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

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

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

注意：模型必须受 Stagehand 支持。请查看此处的文档。使用任何自定义模型时，都必须提供该提供商的 API 密钥。

资源

该服务提供对屏幕截图资源的访问：

1. 屏幕截图（screenshot://<screenshot-name>）
   • 捕获的屏幕截图 PNG 图像

主要功能

• AI 驱动的自动化：通过自然语言命令与网页交互
• 支持多种模型：支持 OpenAI、Claude、Gemini 等
• 高级会话管理：支持单会话和多会话，可并行执行浏览器自动化
• 截图：支持整页截图和指定元素截图
• 数据提取：智能提取网页内容
• 代理支持：具备企业级代理功能
• 隐身模式：高级反检测功能
• 上下文持久化：在不同会话间保留身份验证信息和状态
• 并行工作流：同时运行多个浏览器会话，以处理复杂的自动化任务

如需了解更多关于 Model Context Protocol 的信息，请访问：

• MCP 文档
• MCP 规范

官方 MCP 文档：

• Browserbase MCP

许可证

根据 Apache 2.0 许可证授权。

版权所有 2025 Browserbase, Inc.