用途:通过 Playwright MCP 服务器自动化浏览器交互,适合需要网页导航、表单填写、元素点击、截图和数据提取的任务。
主要能力:支持页面导航与后退、获取无障碍快照(返回元素 ref 供点击/输入)、截图、点击、输入文本、批量填表、下拉选择、等待文本或时间、执行 JavaScript,以及用 browser_run_code 运行多步 Playwright 代码。
使用方式:先启动服务器,推荐 bash scripts/start-server.sh,或手动运行 npx @playwright/mcp@latest --port 8808 --shared-browser-context &。停止可用 bash scripts/stop-server.sh,或调用 browser_close 后 pkill -f "@playwright/mcp"。调用通过 python3 scripts/mcp-client.py call -u http://localhost:8808 -t <工具名> -p '<JSON参数>' 完成。注意 --shared-browser-context 标志必需,否则每次调用都会得到全新浏览器上下文。
典型流程:表单提交为导航、快照取 ref、填字段、点击提交、等待确认、截图;数据提取为导航、快照、必要时用 browser_evaluate、处理结果。
限制与排错:元素找不到先运行 browser_snapshot 获取最新 ref;点击失败可先 hover;表单未提交可在 browser_type 中加 "submit": true;页面未加载可增加等待或使用 browser_wait_for。任务结束应停止服务器,长会话可保持运行,浏览器无响应时停止并重启。完整工具文档见 references/playwright-tools.md。