概要

フル名
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アーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/mcp/puppeteer
:latest
linux/amd64linux/arm64
2025/05/27 16:18461.9 MBsha256:4d76219367a1