xTag

镜像概览

完整引用
docker.io/mcp/puppeteer
Registry
docker.io
命名空间
mcp
仓库
puppeteer
已缓存 Tag 数
1
最近同步
07/06/2026, 04:06 PM

简介

Model Context Protocol Puppeteer 服务镜像，为 AI Agent 提供无头浏览器抓取与截图能力，适合 MCP 客户端集成的自动化任务。

详细介绍

mcp/puppeteer 实现 MCP 协议的浏览器工具服务器，LLM Agent 经 stdio 或 HTTP 调用 navigate、screenshot、evaluate 等能力。容器内含 Chromium，内存占用较高，适合作为 Sidecar 或专用 Job 而非高副本 Web 服务。与 Playwright MCP 类似；生产应限制并发、设置 --shm-size，并在 K8s 中配置 memory limit 与 seccomp。

快速启动

docker run -d --name mcp-puppeteer \
  --shm-size=1gb \
  -p 8931:8931 \
  docker.io/mcp/puppeteer:latest

推荐实践

docker run -d --name mcp-puppeteer \
  --restart unless-stopped \
  --shm-size=2gb \
  -p 8931:8931 \
  -e MCP_TRANSPORT=sse \
  -e MAX_CONCURRENT=2 \
  docker.io/mcp/puppeteer:2024.12.0

核心参数说明

  • --shm-size=2gb — Chromium 共享内存，避免崩溃
  • -p 8931:8931 — MCP SSE/HTTP 端口
  • -e MCP_TRANSPORT — 传输模式（stdio/sse）
  • -e MAX_CONCURRENT — 并发浏览器上下文上限
  • --restart unless-stopped — Agent 工具服务持续在线
  • 固定 tag — Chromium 与 MCP 协议版本 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-puppeteer
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mcp-puppeteer
  template:
    metadata:
      labels:
        app: mcp-puppeteer
    spec:
      containers:
        - name: puppeteer
          image: docker.io/mcp/puppeteer:2024.12.0
          ports:
            - containerPort: 8931
          env:
            - name: MCP_TRANSPORT
              value: sse
          resources:
            limits:
              memory: 2Gi
          securityContext:
            runAsNonRoot: true
---
apiVersion: v1
kind: Service
metadata:
  name: mcp-puppeteer
spec:
  selector:
    app: mcp-puppeteer
  ports:
    - port: 8931
      targetPort: 8931

建议低副本并设 memory limit；Agent Pod 经 Service 调用，勿对公网暴露无鉴权端口。

最新 Tag（20 条）

查看全部 1 个 Tag →
Tag架构推送时间大小Digest同步期望操作
docker.io/mcp/puppeteer
:latest
linux/amd64linux/arm64
2025/05/27 16:18461.9 MBsha256:4d76219367a1…