Browserbase

Browserbase MCP 服务器

已归档

此仓库已归档，不再维护。

它最初作为参考实现发布，并出于历史目的保留。不应将其理解为 Browserbase 当前生产服务或实现的代表。

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

此服务器使用 Browserbase 和 Stagehand 提供云端浏览器自动化功能。它使 LLM 能够与网页交互、提取信息并执行自动化操作。

这是 Browserbase 托管 MCP 服务器 的自托管版本，具有相同的工具和功能。我们建议使用托管版本以获得最简单的设置体验。

工具

此服务器公开了 6 个与托管 Browserbase MCP 服务器 相匹配的工具：

工具	描述	输入
start	创建或重用一个 Browserbase 会话	(无)
end	关闭当前的 Browserbase 会话	(无)
navigate	导航到一个 URL	{ url: string }
act	在页面上执行一个操作	{ action: string }
observe	观察页面上可操作的元素	{ instruction: string }
extract	从页面提取数据	{ instruction?: string }

如何设置

我们目前为 MCP 服务器支持两种传输方式：STDIO 和 SHTTP。我们建议您将 SHTTP 与我们的托管 MCP 服务器一起使用，以充分利用服务器的全部能力。

SHTTP (托管 MCP)：

使用位于 https://mcp.browserbase.com/mcp 的 Browserbase 托管 MCP 服务器。这是最简单的入门方式——我们托管服务器并提供 Gemini 的 LLM 成本，Gemini 是 Stagehand 中表现最佳的模型。

有关完整的设置说明，请参阅 Browserbase MCP 文档。

如果您的客户端支持 SHTTP：

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "https://mcp.browserbase.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.browserbase.com/mcp"]
    }
  }
}

STDIO (自托管)：

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

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

通过 NPM 运行 (推荐)

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

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

就是这样！重新加载您的 MCP 客户端，即可开始使用。

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 build -t mcp-browserbase .

然后在您的 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

{
  "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": ""
      }
    }
  }
}

配置

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

标志	描述
--proxies	为会话启用 Browserbase 代理
--verified	启用 Browserbase 验证身份 (仅限 Scale 计划用户)
--advancedStealth	--verified 的已弃用别名
--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 使用的模型 (默认: google/gemini-2.5-flash-lite)
--modelApiKey <key>	自定义模型提供商的 API 密钥 (使用自定义模型时必需)
--experimental	启用实验性功能 (默认: false)

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

注意： 这些标志只能用于自托管服务器 (npx @browserbasehq/mcp 或 Docker)。

模型配置

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

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

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

注意：模型必须在 Stagehand 中受支持。请在此处查看文档。

链接

• Browserbase MCP 文档
• MCP 文档
• MCP 规范
• Stagehand 文档

许可证

根据 Apache 2.0 许可证授权。

版权所有 2025 Browserbase, Inc.