Browserbase MCP 服务器

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

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

功能

如何设置

快速入门：

添加到 Cursor

将此链接复制并粘贴到您的浏览器中：

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

我们目前支持两种传输方式：STDIO 和 SHTTP。我们建议您使用我们的远程托管 URL 来充分利用 SHTTP 的服务器功能。

SHTTP:

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

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

如果您的客户端支持 SHTTP：

{

  "mcpServers": {

    "browserbase": {

      "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。

完全本地运行：

# Clone the Repo

git clone https://github.com/browserbase/mcp-server-browserbase.git

cd mcp-server-browserbase



# Install the dependencies and build the project

pnpm install && pnpm build

然后在您的 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": ""

      }

    }

  }

}

然后重新加载您的 MCP 客户端，您就可以开始使用了！

配置

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

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

注意：

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

配置示例

代理

这里是关于代理的文档。

要使用代理，请在您的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默认使用Google的Gemini 2.0 Flash模型，但您可以配置它以使用其他模型，如GPT-4o、Claude或其他提供商。

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

以下是配置不同模型的方法：

{

  "mcpServers": {

    "browserbase": {

      "command": "npx",

      "args": [

        "@browserbasehq/mcp-server-browserbase",

        "--modelName",

        "anthropic/claude-3-5-sonnet-latest",

        "--modelApiKey",

        "your-anthropic-api-key"

      ],

      "env": {

        "BROWSERBASE_API_KEY": "",

        "BROWSERBASE_PROJECT_ID": ""

      }

    }

  }

}

注意：模型必须被Stagehand支持。请查看此处的文档。当使用任何自定义模型时，您必须提供该提供商的API密钥。

资源

服务器提供了访问截图资源的功能：

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

主要功能

• AI驱动的自动化：用于网页交互的自然语言命令
• 多模型支持：支持OpenAI、Claude、Gemini等
• 高级会话管理：单会话和多会话支持并行浏览器自动化
• 截图捕获：全页和特定元素的截图
• 数据提取：从网页智能提取内容
• 代理支持：企业级代理能力
• 隐身模式：高级反检测功能
• 上下文持久性：跨会话维护认证和状态
• 并行工作流：同时运行多个浏览器会话以完成复杂的自动化任务

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

• MCP文档
• MCP规范

对于官方MCP文档：

• Browserbase MCP

许可证

根据Apache 2.0许可证许可。

版权所有 2025 Browserbase, Inc.