MCP服务器基础浏览

Name: MCP服务器基础浏览
Author: browserbase

作者：browserbase2841 星标更新：2025-11-21

安装使用来源：spider==github.com

项目介绍

Browserbase MCP Server

模型上下文协议 (MCP) 是一个开放协议，它使大型语言模型 (LLM) 应用程序与外部数据源和工具之间的无缝集成成为可能。无论您是在构建 AI 驱动的 IDE，增强聊天界面，还是创建自定义 AI 工作流，MCP 都提供了一种标准化的方法来连接 LLM 和它们所需的上下文。

此服务器使用 Browserbase 和 Stagehand 提供基于云的浏览器自动化能力。它使 LLM 能够与网页进行交互，抓取屏幕截图，提取信息，并以原子精度执行自动化操作。

Stagehand v3 新特性

由 Stagehand v3.0 提供支持，此 MCP 服务器现在包括：

20-40% 更快的性能：通过自动缓存，在所有核心操作 (act, extract, observe) 上提高了速度。
增强的提取：针对 iframes 和 shadow roots 的目标提取和观察。
改进的模式：简化了提取模式，以便更直观地提取数据。
高级选择器支持：CSS 选择器支持，改进了元素定位。
多浏览器支持：兼容 Playwright, Puppeteer 和 Patchright。
新基础：内置 page, locator, frameLocator 和 deepLocator，用于简化自动化。
实验性功能：通过 --experimental 标志启用前沿功能。

更多详情，请访问 Stagehand v3 文档。

特性

功能	描述
浏览器自动化	通过 Browserbase 控制和编排云浏览器
数据提取	从任何网页中提取结构化数据
网页交互	轻松导航、点击和填写表单
屏幕截图	捕获全屏和元素特定的屏幕截图
模型灵活性	支持多种模型（OpenAI, Claude, Gemini 等）
视觉支持	使用注释的屏幕截图处理复杂的 DOM
会话管理	创建、管理和关闭浏览器会话
高性能	通过自动缓存 (v3)，操作速度提高 20-40%
高级选择器	增强的 CSS 选择器支持，实现精确的元素定位

如何设置

快速开始：

添加到 Cursor

在您的浏览器中复制并粘贴以下链接：

cursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19

我们目前支持两种传输方式用于我们的 MCP 服务器，STDIO 和 SHTTP。我们建议您使用 SHTTP 并通过远程托管的 URL 来充分利用服务器的能力。

SHTTP：

要通过远程托管的 URL 使用 Browserbase MCP 服务器，请向您的配置添加以下内容。

前往 smithery.ai 并输入您的 API 密钥和配置以获取远程托管的 URL。当使用我们的远程托管服务器时，我们提供了 Gemini 的 LLM 成本，Gemini 是 Stagehand 中表现最佳的模型。

Smithery 图像

如果您的客户端支持 SHTTP：

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "your-smithery-url.com"
    }
  }
}

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

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "your-smithery-url.com"]
    }
  }
}

STDIO：

您可以使用我们在 NPM 上托管的服务器，或者通过克隆此仓库完全本地运行它。

❗️ 重要提示：如果您想使用不同的模型，必须在参数中添加 --modelName 并提供相应的密钥作为参数。更多信息见下文。

在 NPM 上运行（推荐）

进入您的 MCP 配置 JSON 文件并添加 Browserbase 服务器：

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

就这样！重新加载您的 MCP 客户端，Claude 将能够使用 Browserbase。

完全本地运行：

选项 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 镜像
docker build -t mcp-browserbase .

然后在您的 MCP 配置 JSON 文件中运行服务器。为了本地运行，我们可以使用 STDIO 或自我托管的 SHTTP。

STDIO：

使用直接安装

在您的 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

在您的 MCP 配置 JSON 文件中添加以下内容：

{
  1. "mcpServers": {
  2.     "browserbase": {
  3.         "command": "docker",
  4.         "args": [
  5.             "run",
  6.             "--rm",
  7.             "-i",
  8.             "-e",
  9.             "BROWSERBASE_API_KEY",
 10.             "-e",
 11.             "BROWSERBASE_PROJECT_ID",
 12.             "-e",
 13.             "GEMINI_API_KEY",
 14.             "mcp-browserbase"
 15.         ],
 16.         "env": {
 17.             "BROWSERBASE_API_KEY": "",
 18.             "BROWSERBASE_PROJECT_ID": "",
 19.             "GEMINI_API_KEY": ""
 20.         }
 21.     }
 22. }
 23. }

然后重新加载您的 MCP 客户端，您应该可以开始了！

配置

Browserbase MCP 服务器接受以下命令行标志：

标志	描述
`--proxies`	启用 Browserbase 代理会话
`--advancedStealth`	启用 Browserbase 高级隐身（仅适用于 Scale 计划用户）
`--keepAlive`	启用 Browserbase 保持活动会话
`--contextId <contextId>`	指定要使用的 Browserbase 上下文 ID
`--persist`	是否持久化 Browserbase 上下文（默认：true）
`--port <port>`	监听 HTTP/SHTTP 传输的端口
`--host <host>`	绑定服务器的主机（默认：localhost，使用 0.0.0.0 对于所有接口）
`--browserWidth <width>`	浏览器视口宽度（默认：1024）
`--browserHeight <height>`	浏览器视口高度（默认：768）
`--modelName <model>`	用于 Stagehand 的模型（默认：gemini-2.0-flash）
`--modelApiKey <key>`	自定义模型提供商的 API 密钥（使用自定义模型时需要）
`--experimental`	启用实验性功能（默认：false）

这些标志可以直接传递给 CLI 或配置在您的 MCP 配置文件中。

注意事项：

目前，这些标志只能与本地服务器一起使用（npx @browserbasehq/mcp-server-browserbase 或 Docker）。

使用 Docker 配置标志

当使用 Docker 时，可以在镜像名称之后作为附加参数传递配置标志。这里是一个带有 --proxies 标志的例子：

{
  "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 容器：

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

配置示例

代理

这里是关于代理的文档。

要使用代理，请在您的 MCP 配置中设置 --proxies 标志：

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

高级隐身

这里是关于高级隐身的文档。

要使用高级隐身，请在您的 MCP 配置中设置 --advancedStealth 标志：

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

上下文

这里是关于上下文的文档。

要使用上下文，请在您的 MCP 配置中设置 --contextId 标志：

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp-server-browserbase",
        "--contextId",
        "<YOUR_CONTEXT_ID>"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

浏览器视口尺寸

浏览器会话的默认视口尺寸是 1024 x 768。您可以使用 browserWidth 和 browserHeight 标志调整浏览器视口尺寸。

这是如何使用自定义浏览器尺寸的示例。我们建议使用 16:9 的宽高比（例如：1920 x 1080，1280 x 720，1024 x 768）

{
  "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 标志启用的实验性功能。这些功能提供了正在积极开发和完善的前沿功能。

要启用实验性功能：

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

注意：实验性功能可能会在未来版本中更改或移除。请自行决定使用它们。

模型配置

Stagehand 默认使用 Google 的 Gemini 2.0 Flash 模型，但您可以将其配置为使用其他模型，如 GPT-4o, Claude 或其他提供商。

重要提示：当使用任何自定义模型（非默认）时，您必须使用 --modelApiKey 标志提供该模型提供商的 API 密钥。

这是如何配置不同模型的示例：

{
  "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 中受支持。查看文档此处。当使用任何自定义模型时，您必须提供该提供商的 API 密钥。

资源

服务器提供了对屏幕截图资源的访问：

屏幕截图 (screenshot://<screenshot-name>)
- 捕获的屏幕截图的 PNG 图像

关键特性

AI 驱动的自动化：用于网页交互的自然语言命令
多模型支持：与 OpenAI, Claude, Gemini 等兼容
屏幕截图捕获：全屏和元素特定的屏幕截图
数据提取：从网页中智能提取内容
代理支持：企业级代理功能
隐身模式：高级防检测功能
上下文持久性：跨会话维护身份验证和状态

有关 Model Context Protocol 的更多信息，请访问：

对于官方 MCP 文档：

Browserbase MCP

许可证

根据 Apache 2.0 许可证授权。