用途:当需要浏览器引擎覆盖或 Playwright 专属测试能力,而非轻量 Chromium 自动化时,使用官方 Playwright MCP 服务器。适合 Firefox 专属缺陷、WebKit/Safari 类复现、Edge 专属行为、Firefox/WebKit/Edge 跨引擎对比,以及移动模拟、网络 mock、生成的 Playwright 代码、trace/video 产物等场景。常规 Chrome/Chromium 表单流程、截图、抓取应改用 agent-browser;当前 Chrome 会话、DevTools 元素、控制台/网络/Lighthouse/性能排查应改用 chrome-devtools-mcp。
主要能力与用法:仓库托管设置通过 ./setup.sh opencode --with-playwright-mcp、./setup.sh codex --with-playwright-mcp、./setup.sh copilot --with-playwright-mcp、./setup.sh kiro --with-playwright-mcp 安装。默认提供 Firefox / WebKit / Edge 服务器并带 --headless --caps=testing;可选启用 --playwright-headed(可见浏览器)、--playwright-caps-devtools(trace/video)、--playwright-caps-storage、--playwright-caps-network(网络 mock)、--playwright-isolated、--playwright-output-dir PATH。服务器名:playwright-firefox、playwright-webkit、playwright-msedge,一个实例对应一个引擎,跨引擎需配置多个服务器。
操作规则:表单优先 browser_fill_form,紧凑确定性断言优先 browser_run_code_unsafe,动作确认优先 browser_snapshot,仅在需要图像证据时截图。不要假设受限工具存在,browser_route*、trace/video、storage 助手仅在启用对应选项后可用。本仓库不配置 Playwright Chromium 服务器,不应暗示可用 Chromium 覆盖。深读参考包括 tool-inventory.md、cross-browser-recipes.md、capabilities-and-flags.md、emulation-and-state.md、cdp-and-extension.md、troubleshooting.md。
限制:若当前环境未配置 Playwright MCP,不要临时替换工作流,应告知用户集成尚未安装。移动模拟与扩展/CDP 挂载属于特定能力工作流,不是默认模式。WebKit 是最接近 Safari 类的引擎,但不完全等同所有 Safari 环境细节。