用途:借助 Playwright MCP 服务器自动化浏览器交互,进行网页浏览、表单填写、元素点击、截图与数据提取。
服务器生命周期:启动可使用脚本 bash scripts/start-server.sh,或手动运行 npx @playwright/mcp@latest --port 8808 --shared-browser-context &。停止时先用 python3 scripts/mcp-client.py call -u http://localhost:8808 -t browser_close -p '{}' 关闭浏览器,再执行 pkill -f "@playwright/mcp",也可用 bash scripts/stop-server.sh。任务结束或浏览器无响应时可停止并重启;多个浏览器任务的长会话可保持运行。注意 --shared-browser-context 标志是必须的,否则每次调用都会得到新的浏览器上下文。
主要能力与用法:所有操作通过 python3 scripts/mcp-client.py call -u http://localhost:8808 -t <工具名> -p '<JSON参数>' 调用。导航用 browser_navigate(传入 url)、browser_navigate_back。获取页面状态用 browser_snapshot 得到元素 ref,browser_take_screenshot 截图。交互用 browser_click(element、ref)、browser_type(element、ref、text、submit)、browser_fill_form(fields 数组)、browser_select_option(element、ref、values)。等待用 browser_wait_for(text 或 time)。执行 JavaScript 用 browser_evaluate(function)。复杂多步操作用 browser_run_code(code),适合应原子执行的全有或全无流程。
典型工作流:表单提交为先导航、快照取 ref、填写、点击提交、等待确认、截图;数据提取为先导航、快照或 browser_evaluate 获取内容、再处理结果。验证可运行 python3 scripts/verify.py,预期输出 ✓ Playwright MCP server running;失败时用 pgrep -f "@playwright/mcp" 诊断,检查端口 8808,仍失败应停止并报告,不要继续后续步骤。
限制:元素未找到时需重新运行 browser_snapshot 获取最新 ref;点击失败可先 browser_hover 再点击;表单未提交可在 browser_type 中加 "submit": true;页面未加载可增加等待或用 browser_wait_for;服务器无响应时重启。完整工具文档见 references/playwright-tools.md。安装与收费等其它信息暂未提供。