Playwright MCP Server

社区

基于 Playwright 的浏览器自动化 MCP 服务器

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

66FMRS · C

一个功能成熟的 Playwright 浏览器自动化 MCP 服务器（v1.0.10），支持多客户端、stdio 与 HTTP 两种模式、自动浏览器安装和 143 种设备模拟预设。文档完善、MIT 许可，适合需要 AI 驱动浏览器自动化的开发者。

最强项 · 文档质量 17/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

15/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: README 提到项目使用 Jest 测试（位于 src/__tests__，可通过 npm test 或 run-tests.cjs 运行并生成覆盖率报告），并提供了 evals 包用于端到端评测，这说明作者具备一定的测试意识。故障排查章节列出了真实遇到过的错误（如 HTTP 模式下 'No transport found for sessionId'）及处理步骤，说明关键路径确实被使用过并暴露过问题。但本次审查为纯静态审查，未看到 CI workflow 文件、未验证测试实际覆盖的范围与是否通过，浏览器自动安装/重试逻辑也仅是文字描述而非可核验的代码证据。按静态审查上限（无 CI + 已提交测试的可验证证据不得超过12分）给出9分。
安全与权限 11/20: 该服务器本质上提供浏览器自动化能力（导航任意 URL、执行任意 JavaScript、截图、抓取页面），这类能力天然具有较高的数据接触面，但属于工具声称功能范围内，非隐蔽行为。HTTP 模式默认绑定 localhost，README 明确说明'外部访问被阻止（安全设计）'，体现了一定的最小暴露意识；远程访问需要用户主动做 SSH 隧道，属于显式操作而非默认开放。未发现凭据硬编码、真实密钥示例或隐蔽外传的证据，不触发红线。但 README 全文没有提到对危险操作（如任意导航、执行脚本、填表提交）的确认机制或权限范围声明，也没有说明是否会将用户数据发送到第三方（如 Smithery/mcp-get 安装渠道）。信息不足以证明达到最小权限与显式确认标准，因此在10分基础上略作扣减，给11分。
维护活跃度 15/20: 仓库星标 5633、未被归档、开放 issue 32 个，README 中的'What's New in v1.0.10'章节展示了持续迭代的新功能（143 种设备预设模拟），说明项目仍在积极维护并有版本节奏。License 为 MIT，明确清晰。但 README 未提供最近提交/发布时间、issue 平均响应时间或安全响应渠道等可验证的治理信息，无法确认响应速度与长期维护承诺，因此不能给满分,给15分。
文档质量 17/20: 文档覆盖面广：多种安装方式（npm、mcp-get、Smithery、VS Code 一键安装、Claude Code CLI）、浏览器二进制自动/手动安装说明、stdio 与 HTTP 两种运行模式的配置示例、常见错误的故障排查步骤、测试运行说明及贡献指南，并链接到外部完整文档站点和 API 参考。层次较为丰富且给出可操作示例。不足之处在于具体工具参数、返回格式、超时/成本等细节并未直接包含在 README 内，而是依赖外部文档站点，且没有明确列出已知限制（如支持的浏览器/操作系统边界、并发限制）。综合给17分。
安装易用性 14/20: 安装路径多样且给出了针对不同客户端（Claude Desktop、VS Code、VS Code Insiders、Claude Code CLI）的具体配置代码块,门槛较低,大多为复制粘贴式配置。浏览器二进制自动安装进一步降低了手动步骤。但 HTTP 模式配置存在已知的易错点（缺少 'type: http' 字段导致连接失败,需要专门的故障排查章节),说明实际安装并非完全无摩擦。按静态审查规则,没有可核验的 CI/集成测试证据支撑'安装可复现'的结论,故设置分数上限为15,并结合上述摩擦点给14分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

需要在 Claude Desktop、VS Code 等客户端中自动化浏览器的开发者
从事 Web 测试与爬取的用户

不适合谁

需要严格沙箱隔离、不允许 AI 控制浏览器的环境
Claude Desktop 用户如需 HTTP/SSE 模式（Claude Desktop 目前要求 stdio 模式）

所需权限

在本地运行真实浏览器（Chromium、Firefox、WebKit）
首次使用时自动下载并安装浏览器二进制文件
写入日志文件 ~/playwright-mcp-server.log
在 HTTP 模式下绑定本地端口（默认 8931）

风险与副作用

AI 可在真实浏览器中执行 JavaScript，可能访问和操作敏感网页内容
自动下载浏览器二进制文件占用磁盘与带宽
HTTP 模式仅绑定 localhost，外部访问被禁止，但通过 SSH 隧道暴露仍需谨慎

安装接入

准备工作

运行环境：Node.js

通过 npm 全局安装：npm install -g @executeautomation/playwright-mcp-server；也可使用 mcp-get 或 Smithery（npx @smithery/cli install @executeautomation/playwright-mcp-server --client claude）。在 Claude Desktop 中使用 stdio 模式，配置为 {"mcpServers":{"playwright":{"command":"npx","args":["-y","@executeautomation/playwright-mcp-server"]}}}。VS Code 可通过 code --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}' 安装。首次使用时服务器会自动下载浏览器二进制文件，也可手动运行 npx playwright install。

claude_desktop_config.json

{"mcpServers":{"playwright":{"command":"npx","args":["-y","@executeautomation/playwright-mcp-server"]}}}

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

.vscode/mcp.json

{
  "servers": {
    "playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/playwright-mcp-server"
      ]
    }
  }
}

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

Terminal

claude mcp add playwright -- npx -y @executeautomation/playwright-mcp-server

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

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 playwright_resize 工具；让它“用 iPhone 13 设备视图打开页面”，如能成功模拟设备视口即说明安装成功。

常见排障

HTTP 模式报 "No transport found for sessionId"：确认配置中包含 "type": "http" 字段
端口 8931 被占用导致服务器无法启动：检查端口可用性
外部无法访问：服务器默认只绑定 localhost，远程访问请使用 SSH 隧道
stdio 模式日志写入 ~/playwright-mcp-server.log，控制台不输出日志以保持 JSON-RPC 通信

试试这样问

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

用 iPhone 13 的设备预设打开网页并截图
把浏览器切换到 iPad Pro 11 视图，横屏方向
将视口调整为 Desktop Chrome 桌面模式
旋转到横向方向查看页面布局

工具能力 1

playwright_resize 写入

调整浏览器视口，支持 143 种真实设备预设（如 iPhone 13、iPad Pro 11、Desktop Chrome），可模拟视口、用户代理、触摸事件、设备像素比，并支持横竖屏切换。

使用场景

让 AI 助手操作真实网页并截图

生成 Playwright 测试代码

网页内容抓取

使用 143 种真实设备预设进行设备模拟测试

在真实浏览器环境中执行 JavaScript

支持客户端

Claude Desktop

Claude Code

Cline部分支持

Cursor部分支持

VS Code

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

详细介绍

executeautomation 维护的一个模型上下文协议（MCP）服务器，通过 Playwright 提供浏览器自动化能力。它使大语言模型能够操作网页、截图、生成测试代码、抓取页面内容，并在真实浏览器环境中执行 JavaScript。支持 Claude Desktop、Cline、Cursor IDE、VS Code 等客户端。