Browserbase MCP Server

已归档

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

它最初作为参考实现发布，现保留用于历史参考用途。不应将其解释为代表 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 服务器支持 2 种传输方式：STDIO 和 SHTTP。我们建议你使用 SHTTP 配合我们的托管 MCP 服务器，以充分利用服务器的全部能力。

SHTTP（托管 MCP）：

使用位于 https://mcp.browserbase.com/mcp 的 Browserbase 托管 MCP 服务器。这是开始使用的最简单方式——我们托管服务器，并承担 Gemini（Stagehand 中性能最佳的模型）的 LLM 成本。

完整的设置说明，请参阅 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 上的服务器，也可以通过克隆此仓库在本地完全运行。

注意： 如果你想使用不同的模型，必须在 args 中添加 --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 服务器接受以下命令行标志：

| 标志 | 描述 ...