← 返回目录
P

Playwright MCP

官方
让 AI 智能体通过结构化无障碍树控制浏览器
GitHub 源仓库 ↗
★ 95.2k Stars 分类 · 浏览器自动化 非常热门 源版本 32095eac6a94
43FMRS · D
可靠性
3/20
安全与权限
8/20
维护活跃度
17/20
文档质量
9/20
安装易用性
6/20

Playwright MCP 是微软官方生态中面向 AI 智能体的浏览器控制服务器,基于无障碍快照而非截图驱动交互,通过 npx 以 stdio 方式接入主流 MCP 客户端;README 未提供具体工具名称清单,因此工具列表暂缺。

查看 FMRS 评分方法 →

Playwright MCP 是微软 Playwright 项目下的 Model Context Protocol 服务器,通过 npx 启动本地进程,为 AI 智能体提供对 Chromium、Firefox 和 WebKit 的完整浏览器控制能力。智能体通过结构化的无障碍(accessibility)快照而非视觉截图来理解页面内容,并使用元素引用(如 e5、e10)进行点击、输入等交互。文档中提到其工具覆盖导航、表单填写、截图、网络模拟和存储管理等场景。该服务器由 microsoft/playwright-mcp 仓库维护,并在 microsoft/playwright 官方仓库的 README 中作为官方生态项目之一被引用和推荐。

工具能力

暂未整理工具清单。

安装接入

在支持 MCP 的客户端(如 VS Code、Cursor、Claude Desktop、Windsurf 或 Claude Code)的配置中添加一个 MCP 服务器条目,命令为 npx,参数为 ["@playwright/mcp@latest"];VS Code 用户也可以使用仓库提供的一键安装徽章;Claude Code 用户可运行 claude mcp add playwright npx @playwright/mcp@latest。首次运行时 npx 会拉取最新版本的包并启动本地进程,客户端通过标准输入输出(stdio)与其通信。

claude_desktop_config.json
{"mcpServers":{"playwright":{"command":"npx","args":["@playwright/mcp@latest"]}}}

选型与风险

适合谁

  • 希望通过 LLM 驱动浏览器执行开放式网页任务的用户
  • 已经在使用 Claude Desktop、VS Code、Cursor 或 Windsurf 等 MCP 客户端的开发者
  • 需要跨 Chromium、Firefox、WebKit 进行浏览器自动化而不想手写测试脚本的场景

不适合谁

  • 需要完整端到端测试运行器(并行执行、追踪查看器、断言重试)的团队,应使用 Playwright Test 而非 MCP 服务器
  • 更看重 token 效率、不想加载完整工具架构和无障碍树的编码代理场景,README 建议改用更轻量的 Playwright CLI
  • 对浏览器会话、Cookie 或本地文件系统访问有严格隔离要求、不希望智能体获得实际浏览器控制权的场景

所需权限

  • 需要本地 Node.js/npx 环境以启动服务器进程
  • 需要下载并运行 Chromium/Firefox/WebKit 浏览器二进制文件
  • 需要出站网络访问以加载智能体请求导航的目标网页

风险与副作用

  • 服务器授予智能体对真实浏览器的完整控制权,若被恶意提示词误导,可能访问或提交非预期网站的内容
  • 若浏览器会话中已保存登录状态(如 storageState),智能体可能接触到已认证的账户数据
  • README 未说明该 MCP 服务器自身的身份验证或访问控制机制,安全边界主要依赖宿主客户端和用户对目标网址的把控

常见排障

  1. 确认已安装 Node.js 并可执行 `npx @playwright/mcp@latest`
  2. 检查 MCP 客户端配置文件中的 command/args 是否与文档示例一致
  3. 确认客户端支持 MCP 的 stdio 传输方式
  4. 若浏览器无法启动,检查是否需要执行 Playwright 的浏览器安装步骤,以及目标网站的网络可达性

使用场景

让编码助手或聊天机器人在网页上执行导航、点击、表单填写等操作
无需截图或视觉模型,通过结构化无障碍树驱动网页自动化任务
让 AI 智能体验证网页流程(如提交表单、浏览多步骤页面)

支持客户端

Claude Desktop完整支持
Claude Code完整支持
VS Code完整支持
Cursor完整支持
Windsurf完整支持