← 返回目录

Puppeteer MCP Server

官方

已归档

控制无头浏览器完成网页操作与截图

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 浏览器自动化第 6 / 32
Stars: ★ 305 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 16 个月前 ⚠
工具数: 5

62FMRS · C

浏览器自动化能力强、安装直接，但网页操作副作用和会话凭据暴露面较大；当前没有记录 Chromium 启动与 MCP 握手证据。

最强项 · 文档质量 14/20 最弱项 · 维护活跃度 10/20

可靠性

14/20

安全与权限

11/20

维护活跃度

10/20

文档质量

14/20

安装易用性

13/20

已人工审核收录于 2026-07-13

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络控制浏览器

适合谁

需要让助手操作和检查真实渲染网页的测试与采集任务
需要截图、表单填写或浏览器回归检查的开发团队

不适合谁

禁止自动访问外部网站或处理网页账号凭据的环境
需要强反检测或大规模分布式采集的生产系统

所需权限

启动本地 Chromium 进程的权限
访问目标网站的网络权限；登录流程可能需要测试账号

风险与副作用

自动点击和填写表单可能触发真实提交或外部操作
截图、页面内容和浏览器会话可能包含敏感信息

安装接入

准备工作

运行环境：Node.js

直接通过 npx 启动，首次运行会自动下载对应的 Chromium。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中启动该服务器后，检查工具列表中是否出现 navigate、screenshot、click、fill、evaluate；随后让它访问 https://example.com 并截图，能返回截图即说明连接正常。注意：该仓库已归档，官方不再提供安全更新，需自行评估风险。

常见排障

确认 Chromium 已成功下载且可执行
在无桌面环境中启用正确的 headless 参数
检查目标站点网络访问、代理和证书设置

试试这样问

连接成功后，可以直接对 AI 助手这样说：

打开 https://example.com 并截一张页面截图
导航到 example.com，然后在搜索框里填写文字并点击提交按钮
用 evaluate 在当前页面执行一段 JavaScript 并把结果返回给我
帮我截取当前浏览器页面，看看现在显示的是什么

工具能力 5

navigate 写入

导航到指定网址

screenshot 只读

对当前页面截图

click 写入

点击页面上的元素

fill 写入

填写表单输入框

evaluate 写入

在页面中执行自定义脚本

使用场景

对网站关键页面做自动化回归测试

定期截图存档网页内容

抓取需要 JS 渲染的动态页面数据

支持客户端

Claude Desktop

Cursor

Cline

依据项目文档列出，未经本站实测。

详细介绍

驱动 Chromium 完成页面导航、表单填写、点击与截图，让模型能"看见"并操作真实网页，常用于内容抓取与自动化测试场景。

同仓库的其他 Server

源版本 9be4674d1ddf 数据同步于 2026-10-14 查看 FMRS 评分方法