# @browserbasehq/mcp 中文文档

规范地址：https://npmcn.com/package/%40browserbasehq/mcp/

版本：3\.0\.0
npm 元数据更新时间：2026-11-02T16:59:33.737Z
中文译文更新时间：2026-11-08T16:30:34.166Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40browserbasehq/mcp
原文对照：https://npmcn.com/package/%40browserbasehq/mcp/?lang=original
项目主页：https://www.browserbase.com/
源码仓库：https://github.com/browserbase/mcp-server-browserbase

弃用说明：This package is no longer maintained\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.2 MB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2025-05-08T19:57:39.754Z
- 最新版本发布：2026-03-31T01:51:52.916Z
- 近 30 天下载量：8088（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 3 个）

## 中文简介

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

## 安装

```sh
npm install @browserbasehq/mcp
```

也可以使用：`pnpm add @browserbasehq/mcp`、`yarn add @browserbasehq/mcp`、`bun add @browserbasehq/mcp`

## README

# 浏览库 MCP 服务器

![cover](https://npmcn.com/package/%40browserbasehq/mcp/assets/cover.png)

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

此服务器提供云浏览器自动化能力 [浏览器库](https://www.browserbase.com/) 财务报告和审定财务报表 [阶段手](https://github.com/browserbase/stagehand)它使LLMS能够与网页互动,取出信息并进行自动化操作.

这是自制的版本 [浏览器托管了 MCP 服务器](https://mcp.browserbase.com/mcp) 具有相同的工具和功能. **我们建议使用主机版本进行最简单的设置.**

## 工具

此服务器会曝光6种匹配 [主机浏览器 Base MCP 服务器](https://docs.browserbase.com/integrations/mcp/introduction)数字 :

| 工具 | 说明 | 投入 |
| --- | --- | --- |
| `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成本 [最佳业绩模式](https://www.stagehand.dev/evals) 内 [阶段手](https://www.stagehand.dev/)。 。 。 .

完整的设置说明,见 [浏览器库 MCP 文档](https://docs.browserbase.com/integrations/mcp/introduction)。 。 。 .

如果您的客户端支持 SHTTP :

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

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

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

## STDIO(自带):

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

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

### 通过国家预防机制运作(建议)

进入您的 MCP 配置 JSON 并添加浏览器服务器:

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

就这样! 重新装入你的MCP客户端,你准备出发.

### 100%的本地经营:

#### 备选案文1:直接安装

```bash
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build
```

#### 备选案文2:码头

```bash
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .
```

然后在您的 MCP 配置 JSON 运行服务器 :

#### 使用直接安装

```json
{
  "mcpServers": {
    "browserbase": {
      "command": "node",
      "args": ["/path/to/mcp-server-browserbase/cli.js"],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}
```

#### 使用嵌入器

```json
{
  "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` 旗帜.

```json
{
  "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中支持。 检查一下文件 [这里](https://docs.stagehand.dev/examples/custom_llms#supported-llms)。 。 。 ._

## 链接

-   [浏览器库 MCP 文档](https://docs.browserbase.com/integrations/mcp/introduction)
-   [MCP 文档](https://modelcontextprotocol.io/docs)
-   [MCP 规格](https://spec.modelcontextprotocol.io/)
-   [阶段文档](https://docs.stagehand.dev/)

## 许可证

凭"Apache 2.0许可证"获得许可.

版权2025浏览器基地股份有限公司.

## 常见问题

### @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。作者已将其标记为弃用，新项目建议寻找替代方案。