acuvity/mcp-server-browserbase

什么是 mcp-server-browserbase？

该镜像由 Acuvity 基于 Browserbase 的 mcp-server-browserbase 原始源码打包，用于在云端自动化浏览器交互（如网页导航、数据提取、表单填写），提供安全沙箱与运行时防护，确保任务可靠、安全执行。

核心功能

1. 云端浏览器自动化：支持网页导航、数据抓取、表单填写等常见浏览器操作。
2. 安全沙箱机制：
   • 隔离执行环境，防止横向移动；
   • 默认非 root 用户，遵循最小权限原则；
   • 只读文件系统，避免未授权修改；
   • 版本固定，保证部署一致性；
   • CVE 扫描与 SBOM 溯源，提升供应链透明度；
   • Cosign 镜像签名，确保镜像完整性。
3. 运行时防护：集成 Minibridge 实现安全连接，支持敏感模式检测、密钥脱敏、基础认证等防护规则。
4. 多环境兼容：支持 Docker、Kubernetes（Helm）部署，适配 VS Code、Windsurf、Cursor、Claude Desktop、OpenAI SDK 等客户端。

使用场景

• 自动化网页数据采集与分析；
• 浏览器自动化测试；
• Agentic 系统中的浏览器工具集成；
• 需要安全隔离的云端浏览器任务。

配置说明

环境变量

• 必填：BROWSERBASE_API_KEY（Browserbase API 密钥）、BROWSERBASE_PROJECT_ID（项目 ID）。

Docker 部署示例

本地 HTTP/SSE 模式

bash
docker run -it -p 8000:8000 --rm --read-only -e BROWSERBASE_API_KEY=<你的密钥> -e BROWSERBASE_PROJECT_ID=<你的项目ID> docker.io/acuvity/mcp-server-browserbase:2.1.0

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-browserbase": {
      "url": "http://localhost:8000/sse"
    }
  }
}

本地 STDIO 模式

在客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only -e BROWSERBASE_API_KEY -e BROWSERBASE_PROJECT_ID docker.io/acuvity/mcp-server-browserbase:2.1.0

Kubernetes 部署（Helm）

安装命令

bash
helm install mcp-server-browserbase oci://docker.io/acuvity/mcp-server-browserbase --version 1.0.0 --set secrets.BROWSERBASE_API_KEY=<你的密钥> --set secrets.BROWSERBASE_PROJECT_ID=<你的项目ID>

部署后可通过集群内服务 mcp-server-browserbase:8000 访问。

客户端集成示例

VS Code（全局配置）

在用户设置 JSON 中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-browserbase": {
        "env": {
          "BROWSERBASE_API_KEY": "待设置",
          "BROWSERBASE_PROJECT_ID": "待设置"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "BROWSERBASE_API_KEY",
          "-e",
          "BROWSERBASE_PROJECT_ID",
          "docker.io/acuvity/mcp-server-browserbase:2.1.0"
        ]
      }
    }
  }
}

OpenAI Python SDK（本地运行）

python
async with MCPServerStdio(
    params={
        "env": {"BROWSERBASE_API_KEY":"待设置","BROWSERBASE_PROJECT_ID":"待设置"},
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","-e","BROWSERBASE_API_KEY","-e","BROWSERBASE_PROJECT_ID","docker.io/acuvity/mcp-server-browserbase:2.1.0"]
    }
) as server:
    tools = await server.list_tools()

更多配置细节请参考 https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-browserbase%E3%80%82 ===END===