Готовая к производству обертка вокруг chrome-devtools-mcp. chrome-devtools-mcp предоставляет инструменты MCP браузера, но оставляет управление процессом Chrome, многосессионный обмен и восстановление ошибок полностью для вас. Этот проект добавляет операционный уровень, чтобы агенты ИИ могли надежно использовать браузер.

中文文档

Что это добавляет к голым хром-девтулам-мкп

###Управление жизненным циклом Chrome

Автонайти Chrome в вашей системе (macOS/Linux/Windows, поиск 10+ путей, включая Edge/Brave/Arc/Chromium) Ленивый старт — Chrome запускается только на первом tools/call, а не на старте агента

• Несколько сеансов агентов совместно используют один экземпляр Chrome через browser.lock Последний сеанс выхода автоматически закрывает Chrome Никаких сирот после аварии агента: обнаружение сердцебиения родителей + очистка сиротского процесса запуска
• WSL/безголовый Linux: автоматическое обнаружение и настройка DISPLAY (WSLg, Wayland, X11)

Восстановление ошибок

Обнаружение сбоев в Chrome с помощью портового зонда CDP - никогда не доверяйте только тексту ошибки Подтвержденный сбой → автозапуск Chrome, переписывайте MCP-ответ, чтобы сообщить агенту о повторной навигации

• MCP stale state (ссылка на закрытую вкладку) → перезапуск только детского процесса MCP, Chrome остается

my-agent-browser

Production-ready wrapper around chrome-devtools-mcp. chrome-devtools-mcp provides the browser MCP tools, but leaves Chrome process management, multi-session sharing, and fault recovery entirely to you. This project adds the operational layer so AI agents can use the browser reliably.

中文文档

What this adds over bare chrome-devtools-mcp

Chrome Lifecycle Management

• Auto-find Chrome on your system (macOS/Linux/Windows, searches 10+ paths including Edge/Brave/Arc/Chromium)
• Lazy start — Chrome only launches on first tools/call, not at agent startup
• Multiple agent sessions share one Chrome instance via browser.lock reference counting
• Last session to exit automatically closes Chrome
• No orphans after agent crash: parent heartbeat detection + startup orphan process cleanup
• WSL / headless Linux: auto-detect and configure DISPLAY (WSLg, Wayland, X11)

Fault Recovery

• Chrome crash detection via CDP port probe — never trusts error text alone
• Confirmed crash → auto-relaunch Chrome, rewrite MCP response to tell agent to re-navigate
• MCP stale state (referencing closed tab) → restart only the MCP child process, Chrome stays
• Profile lock leftover (SingletonLock after hard kill) → auto-clean before launch

Config-driven + Anti-detection

• Headless mode, proxy, viewport size, custom launch args — all Chrome startup flags configurable
• evaluate_script stack traces are stripped of the pptr: marker and the MCP install path (which normally leaks your OS username) — measured against a site-origin trap, see anti-detection.md
• Flag recommendations backed by one-flag-at-a-time measurements rather than folklore
• Direct connection to existing Chrome (browserUrl mode, for pre-authenticated long-lived sessions)
• Opt-in background tabs via mcp.backgroundNewPages (default false), preserving explicit per-call choices

Agent Workflow Guidance (SKILL.md)

• Heavy pages: file-based snapshots to prevent DOM overflow crashes
• Error recovery: stale UIDs, timeouts, Chrome restart — correct response for each
• Multi-tab: open/extract/close pattern, UID isolation between tabs
• Scraping: URL-based pagination, lazy-load triggering, JS extraction
• Login flows: persistent profile, automated credentials, connect to existing session

Install

npx skills add briqt/my-agent-browser -g -y
npm install -g [email protected]
mkdir -p ~/.config/agent-skills/my-agent-browser
cp ~/.agents/skills/my-agent-browser/config.example.json ~/.config/agent-skills/my-agent-browser/config.json

Then register the MCP server in your agent:

Claude Code

claude mcp add browser -s user -- node ~/.agents/skills/my-agent-browser/scripts/start-mcp.js