acuvity/mcp-server-hyperbrowser

什么是mcp-server-hyperbrowser？

这是由Acuvity打包的安全MCP服务器镜像，基于hyperbrowser-mcp原始源码构建，用于实现网页抓取、数据提取及网页交互自动化功能。镜像集成多重安全特性，确保在Agentic系统中可靠、安全运行。

核心功能

安全特性

• 隔离沙箱: 工具在容器化沙箱内运行，防止横向移动。
• 默认非root用户: 遵循最小权限原则，降低漏洞影响范围。
• 只读文件系统: 确保运行时不可变性，防止未授权修改。
• 版本固定: 锁定工具及依赖版本，保证部署一致性。
• CVE扫描: 通过Docker Scout持续扫描已知漏洞。
• SBOM与溯源: 提供供应链透明度，嵌入元数据和构建信息。
• 容器签名: 使用Cosign进行镜像签名，确保完整性与真实性。

运行时防护

• Minibridge集成: 建立安全Agent-to-MCP连接，支持Rego/HTTP策略执行。
• 防护规则: 包含资源完整性、隐蔽指令检测、敏感模式检测等（默认仅资源完整性开启，可自定义）。

使用场景

1. IDE集成: 支持VS Code、Windsurf、Cursor、Claude Desktop等IDE的MCP配置。
2. 本地部署: 通过Docker实现STDIO/HTTP/sse模式运行。
3. 远程部署: 利用Websocket隧道+MTLS实现安全远程访问。
4. K8s部署: 通过Helm Chart在Kubernetes集群中部署。

配置说明

环境变量

• 必填: HYPERBROWSER_API_KEY（需设置有效密钥）。

Docker部署示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only -e HYPERBROWSER_API_KEY=<你的密钥> docker.io/acuvity/mcp-server-hyperbrowser:1.0.25

远程Websocket模式（需TLS证书）

服务器端启动：

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e HYPERBROWSER_API_KEY=<你的密钥> \
  -e MINIBRIDGE_MODE=backend \
  -v $PWD/certs:/certs \
  -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem \
  -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem \
  docker.io/acuvity/mcp-server-hyperbrowser:1.0.25

客户端通过Minibridge连接：

json
{
  "mcpServers": {
    "acuvity-mcp-server-hyperbrowser": {
      "command": "minibridge",
      "args": [
        "frontend", 
        "--backend", "wss://<远程地址>:8000/ws", 
        "--tls-client-backend-ca", "/path/to/ca.pem", 
        "--tls-client-cert", "/path/to/client-cert.pem", 
        "--tls-client-key", "/path/to/client-key.pem"
      ]
    }
  }
}

Kubernetes部署（Helm）

bash
helm install mcp-server-hyperbrowser oci://docker.io/acuvity/mcp-server-hyperbrowser \
  --version 1.0.0 \
  --set secrets.HYPERBROWSER_API_KEY.value=<你的密钥>

IDE集成示例（VS Code）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-hyperbrowser": {
        "env": {"HYPERBROWSER_API_KEY": "TO_BE_SET"},
        "command": "docker",
        "args": [
          "run", "-i", "--rm", "--read-only", "-e", "HYPERBROWSER_API_KEY", 
          "docker.io/acuvity/mcp-server-hyperbrowser:1.0.25"
        ]
      }
    }
  }
}