Chrome MCP

Chrome MCP предотавляет реальные вкладки Chrome клиентам Model Context Protocol без копирования браузерных сессий в другой движок. Расширение Chrome управляет вкладками в сушествующем профиле ползователя через chrome.debugger, а постоянный локальный демон координирует один или несколько профилей Chrome и процесов MCP.

Архитектура

MCP client ──stdio── MCP bridge ──authenticated HTTP── persistent daemon
                                                        │
                                                        ├── WebSocket ── Chrome extension/profile A ── tabs
                                                        └── WebSocket ── Chrome extension/profile B ── tabs

• Вкладки — это браузерные сессии. Закрытие сессии закрывает её вкладку Chrome.

• Каждая устаовка расшрения предсталяет один профиль/экземпляр Chrome.

• Демон назначает глобальные числовые значеня session_id для каждого подкючённого экземпляра.

• Демон продолжает работу независимо от перезапусков MCP-клиента и не имеет значка в трее.

• Действия используют Chrome DevTools Protocol через chrome.debugger, поэтому выпоняемый JavaScript не блокируется CSP страницы.

• Состояние ауентификации, куки, IndexedDB, сервис-воркеры, сертификаты, расшрения и браузерный отпечаток остаюся в исходном профиле Chrome, поскому перенос сессии не требуется.

Related MCP server: monkeysee

Установка

Требуется Chrome 116 или новее.

bun install

Загрузите расширение в каждый профиль Chrome, который должен быть доступен:

1. Откройте chrome://extensions.

2. Включите режим разработчика.

3. Выберите Загрузить распакованное расширение.

4. Выберите каталог extension этого репозитория.

5. Откройте всплывающее окно расшрения, дайте экземпляру узнаваемое имя и при необходимости выберите Использвать по умолчанию.

Chrome должен иметь доступ к ws://127.0.0.1:55333. Демон принимает WebSocket-соединения расширений только с источников chrome-extension:// и привязывается только к localhost.

Конфигурация MCP-клиента

{
  "mcpServers": {
    "chrome": {
      "command": "bunx",
      "args": ["-y", "@cypherpotato/chrome-mcp", "--mcp"]
    }
  }
}

Для локальной копии после bun link укажите в конфигурации MCP непосредственно связанный исполняемый файл, а не используйте bunx:

{
  "command": "C:\\Users\\<user>\\.bun\\bin\\chrome-mcp-electron",
  "args": ["--mcp"]
}

CLI

chrome-mcp-electron --mcp
chrome-mcp-electron --daemon
chrome-mcp-electron --status
chrome-mcp-electron --stop-daemon
chrome-mcp-electron --help

--mcp запускает демон в фоновом режиме при необходимости, а затем обслуживает MCP через stdio. Закрытие процесса MCP не останавливает демон и не отключает расшрения Chrome.

Инструменты

Публичные имена инструментов и схемы входных данных совпадают с Browser MCP:

• browser_toggle_session

• browser_import_session

• browser_run_actions

• browser_get_context

browser_toggle_session({ "action": "start" }) открывает вкладку в экземпляре Chrome по умолчанию. Когда подключено несколько экземпляров, выберите экземпляр по умолчанию во всплывающем окне расширения. Существующие вкладки, о которых сообщают расширения, также получают значения session_id, и ими можно управлять напрямую.

browser_get_context выводит список всех подключённых экземпляров и их вкладок. URL-адреса возвращаются без строк запроса.

Несколько экземпляров Chrome и профилей

Установите распакованное расширение в каждом профиле. Каждая установка создаёт стабильный случайный идентификатор экземпляра, хранящийся в этом профиле, и автоматически переподключается к демону. Имена экземпляров не обязаны быть уникальными, но рекомендуется использовать различающиеся имена.

Демон синхронизирует вкладки после перезапусков расширения или сервис-воркера.

Сессия остаётся доступной, пока управляющее ею расширение подключено и вкладка всё ещё существует.

Возможности

browser_run_actions поддерживает тот же набор вспомогательных функций браузера, что и Browser MCP:

• снимки и выполнение JavaScript;

• клики, клики правой кнопкой, наведение, перетаскивание, прокрутку и ввод текста;

• навигацию;

• скриншоты;

• консольные и сетевые журналы;

• сведения о сетевых запросах и тела ответов, если Chrome всё ещё хранит их;

• эмуляцию адаптивного вьюпорта и эмуляцию цветовой схемы;

• обработку JavaScript alert, confirm и prompt.

Ограничения

• Chrome разрешает только одно подключение отладчика на вкладку. Закройте DevTools перед управлением этой вкладкой. Открытие DevTools может отключить расширение.

• Внутренние страницы Chrome, страницы расширений, Chrome Web Store и другие ограниченные схемы не могут контролироваться или предоставляться в качестве сессий агента.

• Расширение должно быть установлено в каждом профиле; один профиль не может просматривать вкладки другого профиля.

• Пока вкладка подключена, разрешение на отладку отображает предупреждение Chrome.

• Тела ответов могут исчезать из сетевого буфера Chrome.

• Нативный сенсорный ввод и внутренние CDP API браузера для загрузок не доступны через chrome.debugger.

Разработка

bun run check
bun run test

Тестовый набор использует имитированные WebSocket-клиенты расширения для проверки жизненного цикла постоянного демона, аутентификации, согласования вкладок/сессий, нескольких экземпляров, выбора экземпляра по умолчанию, маршрутизации действий и поведения при переподключении без открытия Chrome.

Внутренний протокол описан в docs/protocol.md.