用途:借助 Playwright MCP 服务器实现实时浏览器控制,用于浏览页面、检查元素、填写表单与调试前端 UI。
主要能力:提供导航(browser_navigate、browser_navigate_back、browser_wait_for、browser_tabs)、检查(browser_snapshot 返回带 ref 值的可访问性树、browser_take_screenshot、browser_console_messages、browser_network_requests)、交互(browser_click、browser_type、browser_fill_form、browser_select_option、browser_hover、browser_drag、browser_press_key、browser_file_upload、browser_handle_dialog)以及进阶能力(browser_evaluate 执行 JS、browser_resize、browser_close、browser_install、browser_run_code)。所有工具前缀为 mcp__playwright__。
使用方式:这些是直接工具调用,不是 CLI 命令;正确形式为 Tool: mcp__playwright__browser_navigate,参数 { "url": "http://localhost:3010" },不要通过 Bash 调用 claude mcp call。交互前必须先 browser_snapshot 获取 ref 值,后续点击、输入、悬停都依赖这些 ref。多字段表单可用 browser_fill_form 一次填写,提交后可用 browser_wait_for 等待再 snapshot 验证。注意输出体积:snapshot 中等偏大,screenshot 为大体积 base64 图片,应少用;理解结构优先用 snapshot。
适用场景:浏览与检查页面布局、填写并提交表单、调试控制台报错与网络请求、走通多步骤流程(如注册向导)等。
限制:MCP 浏览器无法访问需要网络隧道的代理或内网域名,本地 Supabase 应直接用 http://127.0.0.1:54321;异步页面需先等待文本再快照;复杂页面快照输出过大时可导航到子页面或用 browser_evaluate 查询特定元素。若出现无法连接浏览器,可尝试 browser_install 或导航到简单 URL 初始化。