browser-mcp-cdp

browser-mcp-cdp

zhiqi-liMIT
browser-mcp-cdp подключает AI-агентов к вашему реальному локальному Chrome. Сервер работает напрямую через Chrome DevTools Protocol (CDP) — не нужны облачные прокси, API-ключи или отдельные браузеры для автоматизации. Главное отличие — полная изоляция сессии. Вместо того чтобы передавать куки в промпт или запускать тестовый браузер с пустым профилем, сервер копирует ваш профиль Chrome (куки, пароли, IndexedDB) во временную папку при каждом подключении. Агент получает доступ к Gmail, корпоративным дашбордам и банкингу, но его действия не затрагивают оригинальный профиль. После завершения сессии временные данные удаляются. Второе преимущество — общий брокер. Один Chrome обслуживает несколько MCP-клиентов (Claude Desktop, Cursor, VS Code) через Unix-сокет. Брокер сам запускается при первом подключении и завершается после 10 минут бездействия. Это снижает нагрузку на память и синхронизирует состояние между разными инструментами.
ChromeBrowser
Открыть на GitHub

Установка

npx -y browser-mcp-cdp

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

Общее

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

Технологии

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

Описание

Возможности

  • Загрузка страницы по URL с возвратом финального адреса после редиректов
  • Извлечение видимого текста страницы или элемента, а также полного HTML-кода через outerHTML
  • Клики по селекторам и по координатам — click_at пробивает фреймы, оверлеи и модальные окна
  • Установка значений в поля ввода, выпадающие списки и текстовые области
  • Ожидание появления элемента на странице с блокировкой выполнения
  • Прокрутка страницы на произвольное количество пикселей по оси X и Y
  • Скриншот текущего окна в формате PNG
  • Выполнение произвольного JavaScript на странице и получение результата
  • Управление вкладками: список открытых страниц, открытие новых, переключение
  • Изоляция профиля: снапшот кук, localStorage и IndexedDB при старте — реальный профиль не изменяется
  • Общий брокер: один Chrome для нескольких MCP-клиентов через Unix-сокет

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

Для установки выполните команду в терминале. Если используете Claude Desktop:

claude mcp add browser -- npx -y browser-mcp-cdp

Или добавьте конфигурацию вручную в файл настроек MCP-клиента (~/.claude.json):

{ "mcpServers": { "browser": { "command": "npx", "args": ["-y", "browser-mcp-cdp"] } } }

После добавления конфигурации перезапустите MCP-клиент. Сервер сам найдёт установленный Google Chrome на вашей системе (macOS, Windows, Linux).

Требования: Node.js 18+ и браузер Google Chrome. Дополнительные зависимости вроде Playwright не нужны.

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

  • «Загрузи Gmail, подожди загрузки и верни тему последнего письма»
  • «Открой новый тикет в Jira, заполни поле Summary текстом «Ошибка в отчёте» и нажми Create»
  • «Зайди в Яндекс.Метрику, выбери отчёт за вчерашний день и сделай скриншот»
  • «Прокрути документацию вниз на 300 пикселей и извлеки текст второй секции»
  • «На странице банка найди последние транзакции и отфильтруй суммы больше 10 000 рублей»

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

  • Язык: TypeScript
  • Транспорт: stdio (внутренняя коммуникация брокера через Unix-сокет)
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cursor, VS Code и любые другие MCP-клиенты
  • Зависимости: только Node.js 18+
  • Безопасность: изоляция профиля, автоматическая очистка временных данных

Поделиться