用途:在已配置的 Chrome DevTools MCP 上操作现有共享浏览器,完成页面调试、浏览器自动化、视觉检查、控制台与网络分析等任务,同时不干扰无关标签页和已认证状态。
主要能力:可列出页面、创建后台新页面、导航、等待信号、抓取快照、截图、执行脚本,并分析控制台、网络、内存等结果;支持并行处理独立页面。
使用方式:以 ~/.local/libexec/mcp/chrome-devtools 及当前会话暴露的工具为准,不要直接运行 MCP 包。交互前先调用 list_pages,保留初始页面为既有状态;优先用 new_page 且 background: true,记录返回的 pageId,所有页面级工具显式传入 pageId。单页操作保持顺序:导航、等待、重新快照、再交互;导航或 DOM 变化后刷新快照。结构用 take_snapshot,视觉证据用 take_screenshot,无障碍树缺失信息用 evaluate_script。大体积结果用 filePath 写入授权路径或临时位置。
适用场景:需要调试或自动化现有已登录浏览器页面、检查页面结构与视觉、分析控制台与网络请求时。
限制:MCP 仅附加到现有远程调试浏览器,附加失败时不得启动备用浏览器或新建配置文件。浏览器为共享且已认证,只检查任务相关页面,不暴露无关标签页内容。只读检查任务相关认证状态可行,但提交表单、切换账号、安装扩展、购买等外部变更需与浏览器外同等的授权。网络头脱敏是服务端边界,不得绕过。缺失工具即当前会话不可用,不要建议改客户端 MCP 配置。任务结束时只关闭本任务记录的页面,除非用户要求保留。附加或传输失败时,先检查 http://127.0.0.1:${PRB_AGENT_CHROMIUM_PORT:-9222}/json/version,再查看 $XDG_CACHE_HOME/chrome-devtools-mcp/logs/ 或 ~/.cache/chrome-devtools-mcp/logs/ 下最新日志,报告失败层级与证据,不要另启浏览器或改配置。