@browserbasehq/mcp

中文文档
3.0.0发布于 2026/03/31Apache-2.0ES Module构建来源已验证近 30 天下载 8088

使用浏览器库和 Stagehand 实现 AI 网页浏览器自动化的 MCP 服务器

此软件包已被标记为弃用

This package is no longer maintained.

中文使用文档
文档目录10 节
  1. 工具
  2. 如何设置
  3. SHTTP (Hosted MCP): (英语)
  4. STDIO(自带):
  5. 通过国家预防机制运作(建议)
  6. 100%的本地经营:
  7. 配置
  8. 模型配置
  9. 链接
  10. 许可证

浏览库 MCP 服务器

cover

示范背景议定书 是一个开放的协议,能够使LLM应用程序与外部数据源和工具无缝地融合. 无论是在构建AI动力的IDE,增强聊天界面,还是创建自定义的AI工作流程,MCP都提供了一个标准化的方法,将LLMs与它们所需要的上下文连接起来.

此服务器提供云浏览器自动化能力 浏览器库 财务报告和审定财务报表 阶段手它使LLMS能够与网页互动,取出信息并进行自动化操作.

这是自制的版本 浏览器托管了 MCP 服务器 具有相同的工具和功能. 我们建议使用主机版本进行最简单的设置.

工具

此服务器会曝光6种匹配 主机浏览器 Base MCP 服务器数字 :

工具说明投入
start创建或再使用浏览器会话(无)
end关闭当前浏览器库会话(无)
navigate导航到 URL{ url: string }
act在页面上执行动作{ action: string }
observe页面上的可操作元素{ instruction: string }
extract从页面提取数据{ instruction?: string }

如何设置

目前,我们为我们的MCP服务器STIO和SHTTP提供2次运输。 我们建议您使用我们主机的MCP服务器的SHTTP来充分利用服务器.

SHTTP (Hosted MCP): (英语)

使用浏览器库托管的 MCP 服务器 https://mcp.browserbase.com/mcp。这是最容易启动的方法 -- -- 我们主持服务器并提供双子座的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(自带):

你可以使用我们的服务器 托管在国家预防机制上 或完全通过克隆 本地运行它.

说明: 如果你想使用不同的模型,必须添加 -- -- 模型 名称为 args 并提供相应的密钥作为 arg 。 下面有更多信息.

进入您的 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:码头

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

使用嵌入器

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

配置

浏览器Base MCP服务器接受下列命令行旗:

旗帜说明
--proxies启用会话的浏览器库代理
--advancedStealth启用浏览器库高级隐形器( 仅用于缩放计划用户)
--keepAlive启用浏览器库保留会话
--contextId <contextId>指定要使用的浏览器上下文 ID
--persist是否坚持浏览器上下文( 默认: 真)
--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启用实验特性( 默认: 假)

这些旗帜可以直接传递到CLI,或者在您的 MCP 配置文件中配置.

说明: 这些旗帜只能使用自托管服务器(npx@browserbasehq/mcp或Docker).

模型配置

Stagehand默认使用Google的双子座 2.5 Flash Lite 模型,但您可以配置它来使用其他模型,如GPT-4o,克勞德等提供商.

重要: 当使用任何自定义模型( 非默认) 时, 您必须使用 --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浏览器基地股份有限公司.

版本与发布记录

@browserbasehq/mcp 共发布 10 个版本,首次发布于 2025/05/09;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.0.0latest2026/03/317 个月前
2.4.32026/01/249 个月前
2.1.12025/11/2411 个月前
2.1.02025/09/091.2 年前
2.0.02025/07/191.3 年前
1.0.52025/05/181.5 年前

关于 @browserbasehq/mcp 的常见问题

@browserbasehq/mcp 是什么?

使用浏览器库和 Stagehand 实现 AI 网页浏览器自动化的 MCP 服务器注意:该包已被作者标记为弃用——This package is no longer maintained.

如何安装 @browserbasehq/mcp?

在项目目录运行 npm install @browserbasehq/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-browserbase,可以用 npx mcp-server-browserbase 直接运行。

@browserbasehq/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/browserbasehq__mcp 是否存在。

@browserbasehq/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@browserbasehq/mcp 可以商用吗?

@browserbasehq/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@browserbasehq/mcp 的下载量有多少?

根据 npm 官方下载统计,@browserbasehq/mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 8,088 次,日均约 270 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@browserbasehq/mcp 还在维护吗?

最新版本 3.0.0 发布于 2026/03/31(7 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/05/09。作者已将其标记为弃用,新项目建议寻找替代方案。