浏览库 MCP 服务器

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

此服务器提供云浏览器自动化能力 浏览器库 财务报告和审定财务报表 阶段手它使 LLMs 能够与网页交互,取取出截图,取出信息,并以原子精度进行自动化动作.

Stagehand v3 中的新内容

电源 阶段手 v3.0,这个MCP服务器现在包括:

• 20-40% 更快的表现: 在所有核心业务中加快速度act, (中文(简体) ), extract, (中文(简体) ), observe通过自动缓存
• 加强提炼目标取出和观察跨越框架和阴影根
• 改进的Schemas: 简化了提取计划,用于更直观的数据提取
• 高级选择器支持: CSS 选择器支持,改进要素目标
• 多浏览器支持: 与 Playwright、 Puppeteer 和 Patchright 兼容
• 新初级: 内建 page, (中文(简体) ), locator, (中文(简体) ), frameLocator,以及 deepLocator 简化自动化
• 实验特征: 启用与 --experimental 旗帜

详情请访问 阶段手 V3 文档。 。 。 .

特征

如何设置

快速启动 :

添加到光标

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

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

目前,我们为我们的MCP服务器STIO和SHTTP提供2次运输。 我们建议您使用 SHTTP 与我们的远程主机url 充分利用服务器.

嘘

要通过我们远程主机URL使用浏览器Base MCP 服务器,请在您的配置中添加以下内容 .

转到 铁匠.ai 并输入您的 API 密钥和配置,以获取远程主机 URL. 在使用远程主机服务器时,我们提供双子座的LLM成本 最佳业绩模式 内 阶段手。 。 。 .

如果您的客户端支持 SHTTP :

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

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

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

斯地诺:

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

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

运行国家预防机制(建议)

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

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

就这样! 重新装入您的 MCP 客户端, Claude 可以使用浏览器库 .

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:码头

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

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

使用嵌入器

在您的 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客户端,你应该好走!

配置

浏览器Base MCP服务器接受下列命令行旗:

这些旗帜可以直接传递到CLI,或者在您的 MCP 配置文件中配置.

注:

目前,这些旗帜只能与本地服务器(npx@browserbasehq/mcp-server-browserbase或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 配置中设置 -- 代理旗 :

{
  "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": ""
      }
    }
  }
}

浏览器 Viewport 大小

浏览器会话的默认取景口大小为1024 x 768. 您可以用浏览器Width和浏览器Height旗来调整浏览器视图大小.

下面介绍如何使用它来进行自定义浏览器缩放. 我们建议坚持16:9的方格比(即:1920×1080,1280×720,1024×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的双子座2.0 Flash模型,但您可以配置它来使用其他模型,如GPT-4o,克洛德等提供商.

重要: 当使用任何自定义模型( 非默认) 时, 您必须使用 --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://<screenshot-name>(中文(简体) )
   • PNG 截图图像

关键特性

• AI 电源自动化: 用于网络互动的自然语言命令
• 多模式支持:与OpenAI,克洛德,双子座等合作
• 截图抓取: 全页和特定元素截图
• 数据提取: 从网页中提取智能内容
• 代理支持: 企业级代理能力
• 隐形模式: 高级反探测特性
• 背景持久性: 在整个会话中保持认证和状态

关于《示范背景议定书》的更多信息,访问:

• MCP 文档
• MCP 规格

对于官方的MCP Docs:

• 浏览器库 MCP

许可证

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

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