用途
mcp-playwright 是一个 MCP 技能,用于在调试与验证过程中通过浏览器自动化完成任务。它使用配置为 microsoft/playwright-mcp 的 MCP 服务器(@playwright/mcp),执行导航、截图、DOM 检查等浏览器驱动操作,帮助确认 UI 流程是否符合预期。
主要能力
- 浏览器导航与页面访问
- 截图捕获(包括整页截图)
- DOM 检查与元素可见性断言
- 浏览器控制台错误与警告收集
- UI 流程验证
- 回归证据采集(截图 + 控制台错误)
- 无障碍抽查(如关键控件的键盘焦点顺序)
使用方式
前置条件:
- 确保 .vscode/mcp.json 中包含 microsoft/playwright-mcp。
- 若在本地测试,确保应用正在运行(通常为 pnpm run start)。
操作规则:
- 优先使用稳健选择器:data-testid、ARIA 角色/标签。
- 避免脆弱的 CSS 选择器和深层 DOM 耦合。
- 为回归捕获证据:截图 + 控制台错误。
典型工作流:
- 路由冒烟检查:导航到某个 URL,断言主标题/地标可见。
- 回归捕获:针对单个界面变更拍摄前后截图。
- 控制台卫生:收集某个页面的浏览器控制台错误/警告。
- 无障碍抽查:验证关键控件的键盘焦点顺序。
提示模板示例:
- “打开 <URL> 并验证 <元素>。收集控制台错误并拍摄整页截图。”
- “运行快速流程:<步骤>。使用基于角色的选择器,出错时快速失败并截图。”
相关仓库指引:
- 测试组织与选择器规则参见 .github/skills/e2e-playwright。
适用场景
- 调试或验证 Web 应用的 UI 行为
- 执行端到端流程的快速检查
- 采集回归测试所需的视觉与控制台证据
- 对关键交互进行无障碍焦点顺序抽查
限制
- 需要预先配置 microsoft/playwright-mcp 于 .vscode/mcp.json。
- 本地测试需应用处于运行状态。
- 具体安装命令、收费与价格、支持平台等信息暂未提供。