浏览器自动化MCP服务器

Browserbase MCP服务器提供基于云浏览器的自动化能力,使LLM能够与网页交互、提取信息并执行自动化操作。

  • by browserbase
  • TypeScript
  • 混合部署
  • 3397 星标
  • 更新于
在 GitHub 查看 browserbase/mcp-server-browserbase

使用说明

浏览MCP服务器

已归档

此存储库已存档,不再维护。

它最初是作为参考实现发布的,并保留用于历史目的。它不应被解释为Browserbase当前生产服务或实现的代表。

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

此服务器提供云浏览器自动化功能,使用 浏览 和 舞台工作人员它使LLM能够与网页交互、提取信息并执行自动化操作。

这是一个自托管版本的 基于浏览器的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):

使用Browserbase托管的MCP服务器 https://mcp.browserbase.com/mcp。这是最简单的入门方法——我们托管服务器,并为Gemini提供LLM成本 最佳性能模型 在 舞台工作人员.

有关完整的设置说明,请参阅 基于浏览器的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并添加浏览器基础服务器:

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

配置

Browsebase MCP服务器接受以下命令行标志:

标志 描述
--proxies 为会话启用浏览器基础代理
--verified 启用浏览器基础验证身份(仅适用于Scale Plan用户)
--advancedStealth 已弃用的别名 --verified
--keepAlive 启用浏览器保持活动会话
--contextId <contextId> 指定要使用的浏览器基础上下文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默认使用谷歌的Gemini 2.5 Flash Lite模型,但您可以将其配置为使用GPT-4o、Claude或其他提供商等其他模型。

重要:使用任何自定义模型(非默认)时,必须使用 --modelApiKey 旗帜。

{
  "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必须支持该模型。查看文档 这里.

链接

许可证

根据Apache 2.0许可证授权。

版权所有2025 Browserbase,股份有限公司。