Browserbase Local

浏览MCP服务器

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

Stagehand v3的新增功能

由...驱动 舞台手v3.0，此MCP服务器现在包括：

• 性能提高20-40%：提高所有核心业务的速度(act, extract, observe)通过自动缓存
• 增强提取：跨iframe和影子根进行有针对性的提取和观察
• 改进的模式：简化提取模式，实现更直观的数据提取
• 高级选择器支持：CSS选择器支持，改进了元素定位
• 多浏览器支持：与剧作家、木偶师和Patchright兼容
• 新图元：内置 page, locator, frameLocator，以及 deepLocator 简化自动化
• 实验性功能：通过 --experimental 旗帜

有关更多详细信息，请访问 Stagehand v3文档.

特性

如何设置

快速入门：

添加到光标

在浏览器中复制并粘贴此链接：

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

我们目前支持MCP服务器的两种传输方式，STDIO和SHTTP。我们建议您将SHTTP与我们的远程托管url一起使用，以充分利用服务器的全部容量。

shtp:

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

首选 史密斯艾 并输入您的API密钥和配置以获得远程托管URL。 当使用我们的远程托管服务器时，我们提供Gemini的LLM成本 最佳性能模型 在 舞台工作人员.

如果您的客户支持SHTTP：

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

如果您的客户不支持SHTTP：

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

工作室：

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

❗️ 重要提示： 如果你想使用不同的模型，你必须将--modelName添加到参数中，并将相应的键作为参数提供。更多信息如下。

在NPM上运行（推荐）

进入MCP配置JSON并添加浏览器基础服务器：

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

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

要运行100%本地：

选项1：直接安装

# 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:Docker

# 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配置JSON中运行服务器。要在本地运行，我们可以使用STDIO或自主机SHTTP。

工作室：

使用直接安装

在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文件中添加以下内容：

{
  "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客户端，您应该可以开始了！

配置

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

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

注：

目前，这些标志只能用于本地服务器（npx@browserbasehq/mcp服务器浏览器库或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配置中设置--proxy标志：

{
  "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",
        ""
      ],
      "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默认使用谷歌的Gemini 2.0 Flash模型，但您可以将其配置为使用GPT-4o、Claude或其他提供商等其他模型。

重要：使用任何自定义模型（非默认）时，必须使用 --modelApiKey 旗帜。

以下是如何配置不同的模型：

{
  "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密钥。_

资源

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

1. 截图 (screenshot://)

- 捕获的屏幕截图的PNG图像

主要特点

• 人工智能驱动的自动化：用于web交互的自然语言命令
• 多模型支持：与OpenAI、Claude、Gemini等合作
• 截图捕捉：完整页面和特定元素的屏幕截图
• 数据提取：从网页中智能提取内容
• 代理支持：企业级代理功能
• 隐身模式：先进的反检测功能
• 上下文持久性：跨会话维护身份验证和状态

有关模型上下文协议的更多信息，请访问：

• MCP文件
• MCP规范

对于MCP官方文件：

• 浏览MCP

许可证

根据Apache 2.0许可证授权。

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