Chrome DevTools MCP

Chrome DevTools для агентов

Chrome DevTools для агентов (chrome-devtools-mcp) позволяет вашему кодинг-агенту (например, Antigravity, Claude, Cursor или Copilot) управлять живым браузером Chrome и проверять его состояние. Он работает как сервер Model-Context-Protocol (MCP), предоставляя вашему ИИ-ассистенту для программирования доступ ко всей мощи Chrome DevTools для надежной автоматизации, углубленной отладки и анализа производительности. Также предоставляется CLI для использования без MCP.

Справочник инструментов | Журнал изменений | Участие в разработке | Устранение неполадок | Принципы дизайна

Ключевые возможности

• Получение аналитики производительности: Использует Chrome DevTools для записи трассировок и извлечения практических аналитических данных о производительности.
• Расширенная отладка браузера: Анализ сетевых запросов, создание скриншотов и проверка сообщений консоли браузера (с трассировками стека, сопоставленными с исходным кодом).
• Надежная автоматизация. Использует puppeteer для автоматизации действий в Chrome и автоматически ожидает результатов действий.

Отказ от ответственности

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

chrome-devtools-mcp официально поддерживает только Google Chrome и Chrome for Testing. Другие браузеры на основе Chromium могут работать, но это не гарантируется, и вы можете столкнуться с неожиданным поведением. Используйте на свой страх и риск. Мы стремимся предоставлять исправления и поддержку для последней версии Extended Stable Chrome.

Инструменты анализа производительности могут отправлять URL-адреса трассировок в API Google CrUX для получения данных о реальном пользовательском опыте. Это помогает составить целостную картину производительности, представляя полевые данные наряду с лабораторными. Эти данные собираются Chrome User Experience Report (CrUX). Чтобы отключить это, запустите с флагом --no-performance-crux.

Статистика использования

Google собирает статистику использования (например, показатели успешности вызова инструментов, задержку и информацию об окружении) для повышения надежности и производительности Chrome DevTools MCP.

Сбор данных включен по умолчанию. Вы можете отказаться от него, передав флаг --no-usage-statistics при запуске сервера:

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google обрабатывает эти данные в соответствии с Политикой конфиденциальности Google.

Сбор статистики использования для Chrome DevTools MCP компанией Google не зависит от статистики использования браузера Chrome. Отказ от метрик Chrome не означает автоматический отказ от этого инструмента, и наоборот.

Сбор отключается, если установлены переменные окружения CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS или CI.

Проверка обновлений

По умолчанию сервер периодически проверяет реестр npm на наличие обновлений и регистрирует уведомление, когда доступна более новая версия. Вы можете отключить эти проверки обновлений, установив переменную окружения CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

Требования

• Версия Node.js LTS.
• Chrome текущей стабильной версии или новее.
• npm

Начало работы

Добавьте следующую конфигурацию в ваш MCP-клиент:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

[!NOTE] Использование chrome-devtools-mcp@latest гарантирует, что ваш MCP-клиент всегда будет использовать последнюю версию сервера Chrome DevTools MCP.

Если вы заинтересованы только в выполнении базовых задач браузера, используйте режим --slim:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
    }
  }
}

См. Справочник упрощенных инструментов.

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

Инструкции по настройке для вашего редактора или агента (например, Antigravity, Claude Code, Cursor, VS Code) см. в нашем Руководстве по конфигурации клиентов.

Ваш первый запрос

Введите следующий запрос в вашем MCP-клиенте, чтобы проверить, что все работает:

Check the performance of https://developers.chrome.com

Ваш MCP-клиент должен открыть браузер и записать трассировку производительности.

[!NOTE] MCP-сервер автоматически запустит браузер, как только MCP-клиент использует инструмент, требующий запущенного экземпляра браузера. Само по себе подключение к серверу Chrome DevTools MCP не приведет к автоматическому запуску браузера.

Инструменты

Если у вас возникнут какие-либо проблемы, обратитесь к нашему руководству по устранению неполадок. Полный список всех поддерживаемых возможностей MCP см. в Справочнике инструментов.

Конфигурация

Полный список параметров сервера (например, --headless, --isolated, --slim) и способы настройки WebSocket-соединений см. в Руководстве по конфигурации.

Расширенное использование

Для расширенных функций, таких как обработка параллельных сессий, постоянные каталоги пользовательских данных, подключение к запущенному экземпляру Chrome вместо запуска нового или отладка на Android, см. наше Руководство по расширенному использованию.

Интеграция в качестве браузерного субагента

Если вы разрабатываете инструменты для агентов и хотите предоставить интегрированного браузерного субагента как часть вашего продукта, мы рекомендуем создавать его на основе Chrome DevTools для агентов.

Для примера реализации см. документацию браузерного агента Gemini CLI.