术语

Chrome DevTools Protocol

Chromium 系浏览器的远程控制接口:程序可以通过本地调试端口检查并操控标签页。

定义

Chrome DevTools Protocol(CDP)是 Chrome 为工具提供的接口:内置开发者工具使用的正是这条通道,它通过本地 WebSocket 开放给其他程序。借助它,程序可以打开标签页、导航、读取 DOM、发送输入事件和截图。

从 Chrome 136 起,浏览器对默认用户数据目录会忽略旧的远程调试启动参数,因此要被程序操控的 Chrome 需要二选一:在 inspect 页面上开启远程调试(Chrome 144+),或者使用拥有独立端口的专用用户数据目录。

来源: Chrome DevTools Protocol · Chrome for Developers: Changes to remote debugging switches · chrome-devtools-mcp: configuration

示例

你用的是 Chrome 144 或更新版本。你打开 chrome://inspect/#remote-debugging,启用远程调试,然后用 --autoConnect 启动 Chrome DevTools MCP。Chrome 询问是否允许连接;你在打算使用的窗口中批准,智能体随后就能列出并操控你打开的标签页。

如果你更想隔离,或者你的 Chrome 版本较旧,就另外启动一个使用独立用户数据目录、监听 9222 端口的 Chrome,并把 MCP 服务器指向 http://127.0.0.1:9222。自 Chrome 136 起,仅靠旧的启动参数已无法在你日常使用的配置文件上生效。两条命令都在下面。

# Mode A: Chrome 144+, remote debugging enabled on chrome://inspect/#remote-debugging
npx -y chrome-devtools-mcp@latest --autoConnect

# Mode B: dedicated profile on a loopback port
"<path to Chrome>" --remote-debugging-port=9222 --user-data-dir="$PWD/.browser/chrome" about:blank
npx -y chrome-devtools-mcp@latest --browserUrl=http://127.0.0.1:9222

对目录站发布为何重要

CDP 让你已登录的浏览器变成智能体可以操作的对象。也正因如此,它需要谨慎对待:调试端口能控制整个浏览器,包括已登录的页面。只监听回环地址、绝不做隧道转发、每批任务结束后关闭端口,这些是设置本身的一部分,而不是可有可无的加固措施。

LaunchRepo 如何处理

BROWSER-SETUP.md 提供两种模式。A:在 Chrome 144+ 的 chrome://inspect 上启用远程调试,让 Chrome DevTools MCP 自动连接,并在目标窗口中批准连接提示。B:启动一个使用独立用户数据目录、监听 127.0.0.1:9222 的专用 Chrome,并把 MCP 服务器指向这个 URL。两种模式不要同时使用,绝不开放公网端口;而且只有可见的标签页真的动起来,才算获得了访问权限,光有一个正在运行的进程不算。

深入阅读

把你的编程智能体连接到你的 Chrome

两种连接模式的分步说明、在公开页面上的冒烟检查,以及一批任务结束后如何关闭调试端口。

在仓库里看这个术语

LaunchRepo 包含 299 份目录站 playbook、一份产品上下文文件和一张提交追踪表,由你自己的智能体运行。一次支付 €49.00,就能用于你拥有的每一个产品。

查看价格