# @browserbasehq/mcp-server-browserbase 中文文档 规范地址：https://npmcn.com/package/%40browserbasehq/mcp-server-browserbase/ 版本：2\.4\.3 npm 元数据更新时间：2026-08-31T16:40:55.503Z 中文译文更新时间：2026-11-08T16:32:13.408Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40browserbasehq/mcp-server-browserbase 原文对照：https://npmcn.com/package/%40browserbasehq/mcp-server-browserbase/?lang=original 项目主页：https://www.browserbase.com/ 弃用说明：This package has moved to @browserbasehq/mcp ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.5 MB，30 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：8 个 - 首次发布：2025-07-28T00:48:10.056Z - 最新版本发布：2026-01-23T23:13:33.015Z - 近 30 天下载量：5128（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：14（近 12 个月 5 个） ## 中文简介 使用浏览器库和 Stagehand 实现 AI 网页浏览器自动化的 MCP 服务器 ## 安装 ```sh npm install @browserbasehq/mcp-server-browserbase ``` 也可以使用：`pnpm add @browserbasehq/mcp-server-browserbase`、`yarn add @browserbasehq/mcp-server-browserbase`、`bun add @browserbasehq/mcp-server-browserbase` ## README # 浏览库 MCP 服务器 [![smithery badge](https://smithery.ai/badge/@browserbasehq/mcp-browserbase)](https://smithery.ai/server/@browserbasehq/mcp-browserbase) ![cover](https://npmcn.com/package/%40browserbasehq/mcp-server-browserbase/assets/cover.png) [示范背景议定书](https://modelcontextprotocol.io/introduction) 是一个开放的协议,能够使LLM应用程序与外部数据源和工具无缝地融合. 无论是在构建AI动力的IDE,增强聊天界面,还是创建自定义的AI工作流程,MCP都提供了一个标准化的方法,将LLMs与它们所需要的上下文连接起来. 此服务器提供云浏览器自动化能力 [浏览器库](https://www.browserbase.com/) 财务报告和审定财务报表 [阶段手](https://github.com/browserbase/stagehand)它使 LLMs 能够与网页交互,取取出截图,取出信息,并以原子精度进行自动化动作. ## Stagehand v3 中的新内容 电源 [阶段手 v3.0](https://github.com/browserbase/stagehand),这个MCP服务器现在包括: - **20-40% 更快的表现**: 在所有核心业务中加快速度`act`, (中文(简体) ), `extract`, (中文(简体) ), `observe`通过自动缓存 - **加强提炼**目标取出和观察跨越框架和阴影根 - **改进的Schemas**: 简化了提取计划,用于更直观的数据提取 - **高级选择器支持**: CSS 选择器支持,改进要素目标 - **多浏览器支持**: 与 Playwright、 Puppeteer 和 Patchright 兼容 - **新初级**: 内建 `page`, (中文(简体) ), `locator`, (中文(简体) ), `frameLocator`,以及 `deepLocator` 简化自动化 - **实验特征**: 启用与 `--experimental` 旗帜 详情请访问 [阶段手 V3 文档](https://docs.stagehand.dev/)。 。 。 . ## 特征 | 特性 | 说明 | | --- | --- | | 浏览器自动化 | 通过浏览器库控制并调节云浏览器 | | 数据提取 | 从任何网页提取结构化数据 | | 网络互动 | 导航、单击和轻松填入表格 | | 截图 | 抓取全页和元素截图 | | 模型灵活性 | 支持多个模型(OpenAI,克洛德,双子座等) | | 愿景支助 | 对复杂的 DOMS 使用附加说明的截图 | | 会话管理 | 创建、管理和关闭浏览器会话 | | 高性能 | 20-40% 使用自动卡管(v3)的快速操作 | | 高级选择器 | 增强CSS选择器对精确元素目标的支持 | ## 如何设置 ### 快速启动 : #### 添加到光标 在浏览器中复制并粘贴此链接 : ```text cursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19 ``` 目前,我们为我们的MCP服务器STIO和SHTTP提供2次运输。 我们建议您使用 SHTTP 与我们的远程主机url 充分利用服务器. ## 嘘 要通过我们远程主机URL使用浏览器Base MCP 服务器,请在您的配置中添加以下内容 . 转到 [铁匠.ai](https://smithery.ai/server/@browserbasehq/mcp-browserbase) 并输入您的 API 密钥和配置,以获取远程主机 URL. 在使用远程主机服务器时,我们提供双子座的LLM成本 [最佳业绩模式](https://www.stagehand.dev/evals) 内 [阶段手](https://www.stagehand.dev/)。 。 。 . ![Smithery Image](https://npmcn.com/package/%40browserbasehq/mcp-server-browserbase/assets/smithery.jpg) 如果您的客户端支持 SHTTP : ```json { "mcpServers": { "browserbase": { "type": "http", "url": "your-smithery-url.com" } } } ``` 如果您的客户端不支持 SHTTP : ```json { "mcpServers": { "browserbase": { "command": "npx", "args": ["mcp-remote", "your-smithery-url.com"] } } } ``` ## 斯地诺: 你可以使用我们的服务器 托管在国家预防机制上 或者通过克隆 完全本地运行它. > **重要内容:** 如果你想使用不同的模型,必须添加 -- -- 模型 名称为 args 并提供相应的密钥作为 arg 。 下面有更多信息. ### 运行国家预防机制(建议) 进入您的 MCP 配置 JSON 并添加浏览器服务器: ```json { "mcpServers": { "browserbase": { "command": "npx", "args": ["@browserbasehq/mcp-server-browserbase"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` 就这样! 重新装入您的 MCP 客户端, Claude 可以使用浏览器库 . ### 100%的本地经营: #### 备选案文1:直接安装 ```bash # Clone the Repo git clone https://github.com/browserbase/mcp-server-browserbase.git cd mcp-server-browserbase # Install the dependencies and build the project npm install && npm run build ``` #### 备选案文2:码头 ```bash # Clone the Repo git clone https://github.com/browserbase/mcp-server-browserbase.git cd mcp-server-browserbase # Build the Docker image docker build -t mcp-browserbase . ``` 然后在你的MCP Config JSON运行服务器. 为了在当地运行,我们可以使用STIO或自主机SHTTP. ### 斯地诺: #### 使用直接安装 在您的 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": "" } } } } ``` #### 使用嵌入器 在您的 MCP 配置 JSON 文件中添加以下内容 : ```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": "" } } } } ``` 然后重新装入你的MCP客户端,你应该好走! ## 配置 浏览器Base MCP服务器接受下列命令行旗: | 旗帜 | 说明 | | --- | --- | | `--proxies` | 启用会话的浏览器库代理 | | `--advancedStealth` | 启用浏览器库高级隐形器( 仅用于缩放计划用户) | | `--keepAlive` | 启用浏览器库保留会话 | | `--contextId ` | 指定要使用的浏览器上下文 ID | | `--persist` | 是否坚持浏览器上下文( 默认: 真) | | `--port ` | HTTP/ SHTTP 运输的监听端口 | | `--host ` | 将服务器绑定为主机( 默认: localhost, 对所有接口使用 0.0. 0.0) | | `--browserWidth ` | 浏览器视图宽度( 默认: 1024) | | `--browserHeight ` | 浏览器取景口高度( 默认为768) | | `--modelName ` | Stagehand 使用的模型( 默认: 遗传- 2.0- flash) | | `--modelApiKey ` | 用于自定义模型提供者的 API 密钥( 在使用自定义模型时需要) | | `--experimental` | 启用实验特性( 默认: 假) | 这些旗帜可以直接传递到CLI,或者在您的 MCP 配置文件中配置. ### 注: 目前,这些旗帜只能与本地服务器(npx@browserbasehq/mcp-server-browserbase或Docker)使用. ### 使用带有多克的配置旗 在使用多克时,可以在图像名后通过配置旗作为附加参数. 举个例子 `--proxies` 旗帜 : ```json { "mcpServers": { "browserbase": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "BROWSERBASE_API_KEY", "-e", "BROWSERBASE_PROJECT_ID", "-e", "GEMINI_API_KEY", "mcp-browserbase", "--proxies" ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` 您也可以直接从命令行运行 Docker 容器 : ```bash docker run --rm -i \ -e BROWSERBASE_API_KEY=your_api_key \ -e BROWSERBASE_PROJECT_ID=your_project_id \ -e GEMINI_API_KEY=your_gemini_key \ mcp-browserbase --proxies ``` ## 配置示例 ### 代理 我们的医生来了 [代理](https://docs.browserbase.com/features/proxies)。 。 。 . 要使用代理, 请在您的 MCP 配置中设置 -- 代理旗 : ```json { "mcpServers": { "browserbase": { "command": "npx", "args": ["@browserbasehq/mcp-server-browserbase", "--proxies"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` ### 高级隐形 我们的医生来了 [高级隐形](https://docs.browserbase.com/features/stealth-mode#advanced-stealth-mode)。 。 。 . 要使用高级隐形, 请在您的 MCP 配置中设置 --advancedStealth 旗帜 : ```json { "mcpServers": { "browserbase": { "command": "npx", "args": ["@browserbasehq/mcp-server-browserbase", "--advancedStealth"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` ### 背景情况 我们的医生来了 [背景情况](https://docs.browserbase.com/features/contexts) 要使用上下文, 请在 MCP 配置中设置 -- contextId 旗帜 : ```json { "mcpServers": { "browserbase": { "command": "npx", "args": [ "@browserbasehq/mcp-server-browserbase", "--contextId", "" ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` ### 浏览器 Viewport 大小 浏览器会话的默认取景口大小为1024 x 768. 您可以用浏览器Width和浏览器Height旗来调整浏览器视图大小. 下面介绍如何使用它来进行自定义浏览器缩放. 我们建议坚持16:9的方格比(即:1920×1080,1280×720,1024×768) ```json { "mcpServers": { "browserbase": { "command": "npx", "args": [ "@browserbasehq/mcp-server-browserbase", "--browserHeight 1080", "--browserWidth 1920" ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` ### 实验特征 Stagehand v3 包含可以启用的实验特性 `--experimental` 旗帜。 这些特点提供了正在积极发展和完善的前沿能力. 为使实验性特征得以实现: ```json { "mcpServers": { "browserbase": { "command": "npx", "args": ["@browserbasehq/mcp-server-browserbase", "--experimental"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } } } ``` _注:实验性特征在未来释放中可能改变或被去除. 随便你用._ ### 模型配置 Stagehand默认使用Google的双子座2.0 Flash模型,但您可以配置它来使用其他模型,如GPT-4o,克洛德等提供商. **重要**: 当使用任何自定义模型( 非默认) 时, 您必须使用 `--modelApiKey` 旗帜. 以下是如何配置不同的模型: ```json { "mcpServers": { "browserbase": { "command": "npx", "args": [ "@browserbasehq/mcp-server-browserbase", "--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)。在使用任何自定义模式时,您必须为该提供者提供自己的 API 密钥._ ### 资源 服务器提供截图资源访问权限 : 1. **截图** (单位:千美元)`screenshot://`(中文(简体) ) - PNG 截图图像 ## 关键特性 - **AI 电源自动化**: 用于网络互动的自然语言命令 - **多模式支持**:与OpenAI,克洛德,双子座等合作 - **截图抓取**: 全页和特定元素截图 - **数据提取**: 从网页中提取智能内容 - **代理支持**: 企业级代理能力 - **隐形模式**: 高级反探测特性 - **背景持久性**: 在整个会话中保持认证和状态 关于《示范背景议定书》的更多信息,访问: - [MCP 文档](https://modelcontextprotocol.io/docs) - [MCP 规格](https://spec.modelcontextprotocol.io/) 对于官方的MCP Docs: - [浏览器库 MCP](https://docs.browserbase.com/integrations/mcp/introduction) ## 许可证 凭"Apache 2.0许可证"获得许可. 版权2025浏览器基地股份有限公司. ## 常见问题 ### @browserbasehq/mcp-server-browserbase 是什么？ 使用浏览器库和 Stagehand 实现 AI 网页浏览器自动化的 MCP 服务器注意：该包已被作者标记为弃用——This package has moved to @browserbasehq/mcp ### 如何安装 @browserbasehq/mcp-server-browserbase？ 在项目目录运行 npm install @browserbasehq/mcp-server-browserbase，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-browserbase，可以用 npx mcp-server-browserbase 直接运行。 ### @browserbasehq/mcp-server-browserbase 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/browserbasehq\_\_mcp-server-browserbase 是否存在。 ### @browserbasehq/mcp-server-browserbase 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @browserbasehq/mcp-server-browserbase 可以商用吗？ @browserbasehq/mcp-server-browserbase 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @browserbasehq/mcp-server-browserbase 的下载量有多少？ 根据 npm 官方下载统计，@browserbasehq/mcp-server-browserbase 在 2026/10/09 – 2026/11/07 这 30 天内被下载 5,128 次，日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @browserbasehq/mcp-server-browserbase 还在维护吗？ 最新版本 2\.4\.3 发布于 2026/01/24（9 个月前）；至今共发布 14 个版本，其中过去 12 个月发布了 5 个；首次发布于 2025/07/28。作者已将其标记为弃用，新项目建议寻找替代方案。