chrome-driverless

基于 Playwright 驱动的一个有头（headed + xvfb）持久化 Chrome，对外提供一套 MCP 风格 HTTP 接口（/mcp），用于：导航、截图、点击、输入、多 Tab、多 Profile、代理切换、鼠标/触控板控制、AI 任务执行、浏览器自愈、登录态导出（cookies / auth.json）。

浏览器为持久化 context，登录态保存在 data/profiles/<name>/auth.json（也可由环境变量 BROWSER_DATA_DIR 覆盖）。可嵌入到任意 Web 应用主界面，以页面内 Tab 形式打开本控制台使用。

快速开始

pip install -r requirements.txt
python main.py            # 默认 0.0.0.0:9223

Related MCP server: Chrome DevTools MCP

环境变量

代理默认留空，需要时通过环境变量注入，避免把固定地址写进代码。

HTTP 接口

• GET / —— Web 控制台（内置 tab 页面，暗色界面）

• GET /health

• POST /mcp —— MCP 方法调用，body {"method":"pw/...","params":{...}}

• GET /debug/status、/debug/logs、/debug/files、/debug/url —— 运行状态 / 日志 / 产物 / 地址

• GET /devtools/targets、GET /devtools/{rest} —— Chrome DevTools 调试入口

常用 MCP 方法

嵌入到 Web 主界面

1. 通过 docker / docker-compose 运行本服务，暴露端口 9223。

2. 在 Web 应用前端设置 CHROME_DRIVERLESS_URL=http://<host>:9223。

3. 在前端加一个入口（如导航栏的"内置浏览器"），以页面内 Tab / iframe 形式打开本控制台地址。

4. 在浏览器中登录目标站点，登录态自动保存（auth.json），供后续脚本 / CDP 连接复用。

本服务自身无外部登录，作为内网 / 嵌入式工具直接使用。若需访问控制，请在前置反向代理上加。

声明

仅用于个人学习 / 自用自动化。请遵守各网站的服务条款。