用途:这是 Chrome DevTools MCP 的排障技能,在 list_pages、new_page、navigate_page 失败或服务器无法启动时触发,帮助用户配置和修复 MCP 服务器。
主要能力:按步骤定位并读取 MCP 配置文件(如 .mcp.json、.vscode/mcp.json、gemini-extension.json、.gemini/settings.json,必要时含 ~/.claude.json),识别错误参数、缺失环境变量、在不兼容环境使用 --autoConnect 等问题;分诊常见连接错误,如 Could not find DevToolsActivePort、服务启动但创建新的空 profile、工具缺失只暴露只读工具、扩展工具缺失、Target closed、Tool not found、缺少 pageId、ProtocolError: Network.enable timed out、ERR_MODULE_NOT_FOUND 及沙箱或主机校验错误。
必要用法:先检查配置,无法找到文件时再向用户索取配置内容。针对 DevToolsActivePort 错误,先确认正确的 Chrome 版本在运行,再让用户打开 chrome://inspect/#remote-debugging 勾选 Enable remote debugging,随后仅调用 list_pages 验证。若仍失败,再考虑 --browser-url=http://127.0.0.1:9222、添加 --logFile、增大 startup_timeout_ms,或运行 npx chrome-devtools-mcp@latest --help 与 NODE_DEBUG=* npx chrome-devtools-mcp@latest --logFile=/tmp/cdm-test.log 获取日志。必要时可用 gh issue list --repo ChromeDevTools/chrome-devtools-mcp --search "<error snippet>" --state all 检索已有问题。
适用场景与限制:适用于本机或容器中 Chrome DevTools MCP 连接、目标与工具可用性排障。需要注意的是,只读模式会限制工具范围,需在客户端关闭;扩展类工具需传入 --categoryExtensions;--slim 仅启用导航、脚本求值和截图工具;--autoConnect 需运行 Chrome 144+。其他具体价格、平台等信息暂未提供。