← 返回目录
P

Playwright MCP Server

社区
基于 Playwright 的浏览器自动化 MCP 服务器
GitHub 源仓库 ↗
★ 5.6k Stars 分类 · 浏览器自动化 热门
66FMRS · C

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

可靠性
9/20
安全与权限
11/20
维护活跃度
15/20
文档质量
17/20
安装易用性
14/20
查看 FMRS 评分方法 →

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

工具能力

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

安装接入

通过 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 等客户端中自动化浏览器的开发者
  • 从事 Web 测试与爬取的用户

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

让 AI 助手操作真实网页并截图
生成 Playwright 测试代码
网页内容抓取
使用 143 种真实设备预设进行设备模拟测试
在真实浏览器环境中执行 JavaScript

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Cline部分支持
Cursor IDE部分支持
VS Code完整支持