Chrome Debugger MCP

Chrome Debugger MCP

BiteProMIT
1 звёзд
Chrome Debugger MCP подключает AI-агента к рантайму JavaScript в Chrome через Chrome DevTools Protocol. Агент приостанавливает выполнение на брейкпоинтах, читает значения реальных переменных в скоупе и выполняет код в контексте текущего фрейма. Сервер решает задачу, с которой сталкиваются агенты при работе с браузером. Статический анализ кода не показывает актуальных данных. Агенту приходится догадываться. Chrome Debugger MCP устраняет эту неопределённость: агент работает с фактами из памяти. Это не инструмент для автоматизации действий в браузере вроде кликов и заполнения форм. Это отладочный инструмент, адаптированный для машинного потребления. Он замыкает петлю отладки, которую разработчик использует в Chrome DevTools: подключиться к вкладке, приостановиться в нужном месте, проверить значения, при необходимости сделать шаг и продолжить.
DevelopmentChromeBrowser
Открыть на GitHub

Установка

npx -y chrome-debugger-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикBitePro
  • ЛицензияMIT

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Приостанавливает выполнение кода на брейкпоинтах и командах debugger;.
  • Читает значения переменных из локального, замыкающего и модульного скоупов.
  • Выполняет произвольные JavaScript-выражения в контексте текущего кадра вызова.
  • Делает шаги по коду (step over, step into, step out).
  • Запускает новый экземпляр Chrome с включённым портом для удалённой отладки.
  • Ставит и снимает точки останова в DevTools без правки исходных файлов.
  • Перезагружает страницу через CDP для надёжной привязки брейкпоинтов.
  • Запрашивает подтверждение у пользователя перед подключением к вкладке.
  • Передаёт сервисные сообщения (_ui) и логи для отображения в интерфейсе клиента.
  • Опрашивает состояние отладчика при коротких таймаутах запросов MCP-клиента.

Как подключить

1. Установите или запустите сервер одной командой:

npx -y chrome-debugger-mcp

Для постоянного использования установите пакет глобально:

npm install -g chrome-debugger-mcp

2. Пропишите сервер в конфигурации MCP-клиента. Например, для Claude Desktop отредактируйте файл claude_desktop_config.json:

{ "mcpServers": { "chrome-debugger": { "command": "npx", "args": ["-y", "chrome-debugger-mcp"] } } }

3. Сохраните изменения и перезапустите клиент. Набор инструментов для отладки Chrome появится в списке доступных.

Примеры запросов

  • «Найди в коде обработчик отправки формы. Установи на нём брейкпоинт и запусти форму. Когда сработает брейкпоинт, покажи содержимое объекта event и все переменные в скоупе.»
  • «Приостанови выполнение на строке 15 в файле app.js. Выполни в контексте фрейма document.title и покажи результат.»
  • «Сделай шаг с заходом (step into) в функцию checkAuth. Какие значения у аргументов? Продолжи выполнение после инспекции.»
  • «Подключись к открытой вкладке с приложением, дождись появления кнопки "Купить", установи брейкпоинт на клик и приостанови выполнение, когда нажмут.»

Технические детали

  • Язык: JavaScript (Node.js)
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: BitePro
  • Совместимость: Любые MCP-клиенты с поддержкой stdio-транспорта (Claude Desktop, Continue.dev)
  • Зависимости: Установленный Google Chrome на локальной машине

Поделиться