Puppeteer MCP：给 AI 一个真实的浏览器

把真实浏览器交给 AI 控制，渲染 JS 页面、截图、填表、跑自动化。

连接器名称：Puppeteer MCP Server（@modelcontextprotocol/server-puppeteer）
传输方式：stdio
适用客户端：Claude Code、Claude Desktop、Cursor、Windsurf、Cline 等支持 MCP 的客户端
配置示例：

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

仓库地址：https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer

很多“抓取网页”的需求，静态 HTTP 客户端根本搞不定——现代页面大量依赖 JavaScript 渲染，数据要等脚本跑完才出现，表单要点击、等待、输入才能提交。Puppeteer MCP Server 由 Model Context Protocol 官方团队维护，是 modelcontextprotocol/servers 仓库的一部分，它把一套完整的浏览器自动化能力通过 MCP 暴露给 AI 客户端。装上之后，Claude 这类模型就能驱动一个无头 Chromium 实例：打开 URL、截图、点击元素、填表、执行页面 JavaScript，把“看网页、操作网页”变成可编排的工具调用。

核心能力

1. 渲染型网页抓取：直接让 AI 加载一个 URL 并从渲染后的 DOM 抽取结构化数据，包括那些静态 HTTP 客户端无法解析的 JS 重页面。场景：要抓取某 SPA 后台列表里分页加载的数据，普通爬虫只能拿到空壳，Puppeteer 能等脚本渲染完再取数。
2. 截图：对任一可公开访问的 URL 抓取整页或视口截图，并把图片作为结果返回。场景：让 AI 在对话里打开一个页面、截图确认视觉布局，或批量给一批网页生成预览图。
3. 表单填写与交互：指示 AI 定位输入框、填入值、提交表单，或点击链接、等待元素出现、滚动页面。场景：把“登录后导出报表”这种多步操作交给 Agent 串起来自动完成。
4. 浏览器自动化与 UI 测试：让 AI 验证某元素在交互后是否存在、可见或包含预期文字。场景：在写代码的同时让 Agent 跑一遍浏览器冒烟测试，确认按钮点击后弹出了正确提示。
5. 执行页面 JavaScript：通过 puppeteer_evaluate 在页面上下文里运行任意 JS，提取动态内容或读取运行时状态。场景：需要从页面 window 对象里读某个配置、或统计某些 DOM 节点数量时直接求值。

使用上手

1. 确认环境：安装 Node.js 18 或更高版本，首次运行该 server 会自动下载 Chromium。
2. 配置客户端：在 Claude Desktop 的 claude_desktop_config.json 或 Claude Code 项目根的 .claude/mcp.json 中加入上述 JSON（仅 command + args 即可）。
3. 重启客户端会话，让新 server 被识别加载。
4. 在对话里直接下指令，例如“打开 https://example.com，截一张整页图，并告诉我标题文字”。
5. 复杂任务先确认目标站点允许自动化访问，避免触发反爬或封禁。

优点与不足

• 优点：渲染 JS 页面、处理交互，能力远超简单 HTTP 抓取；官方维护、与主流 MCP 客户端开箱兼容；配置只需一行 npx，零额外依赖。
• 不足：登录态（Cookie、OAuth、多因子）需要额外编排，server 本身不原生处理；每次会话都是全新浏览器上下文，Cookie 和本地存储不跨重启持久化；启动 Chromium 较占内存，CI/容器需补齐 libnss3 等系统库；遇到 Cloudflare、reCAPTCHA 等反爬可能被判为机器人。

适合谁

• 在 AI 编程工作流里需要“会操作浏览器”的开发者（爬虫、E2E 测试、页面巡检）。
• 想让 AI 实时打开某个 URL、截图核对的互动型用户。
• 需要在无头环境做轻量 UI 验证的测试与运维同学。

下载与访问

• 仓库地址：https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer
• 安装命令：npx -y @modelcontextprotocol/server-puppeteer
• 适用客户端：Claude Code、Claude Desktop、Cursor、Windsurf、Cline 等

许可证与获取

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。