Chrome Control MCP

Видимое и точное управление Chrome для ИИ-ассистентов. Локально по замыслу.

Быстрый старт · Каталог инструментов · Архитектура · Безопасность · Верификация

Активная автоматизация остаётся видимой: розовая рамка, значок AI CONTROL и пульсирующий курсор агента показывают, когда ассистент управляет Chrome. Скриншоты для модели скрывают этот оверлей по умолчанию; документационные снимки могут включать его по желанию.

Зачем этот проект

Все 43 инструмента MCP используют строгие JSON-схемы. Долгоживущий процесс MCP сохраняет состояние сеанса и ссылок на элементы, пока Chrome остаётся обычным браузером под управлением пользователя.

Related MCP server: Chrome MCP Server

Как это работает

Оба изображения — прямые результаты browser_screenshot из живого расширения, а не макеты.

Благодарность за тестирование: UI Test Automation Playground от Inflectra и открытый репозиторий предоставляют сфокусированные, практичные сценарии взаимодействия с браузером. Они оказались бесценны для тестирования полного пути MCP-к-Chrome в этом проекте.

Быстрый старт

1. Установите требования к сборке

• Windows 10/11 x64, Linux x64 или macOS

• Google Chrome 116+

• CMake 3.25+

• Qt 6.5+ с компонентами Core и Test

• Компилятор C++20: Visual Studio 2022, GCC или Clang

• Node.js 20.19+

2. Соберите и протестируйте

npm ci
npm run build

Вывод по умолчанию:

Пользователи PowerShell могут вместо этого выполнить ./scripts/build.ps1 -Configuration Release. Оба пути собираются с предупреждениями как ошибками и запускают все нативные и расширенческие модульные наборы тестов.

3. Подготовьте Chrome

npm run extension -- install

Откройте chrome://extensions, включите Режим разработчика, выберите Загрузить распакованное, затем выберите папку, выведенную командой. Chrome требует этот один ручной шаг для распакованного расширения.

Не нужны ключ подписи, упакованное расширение, аккаунт в магазине, права администратора или корпоративная политика. Публичный key в manifest.json лишь закрепляет ID распакованного расширения; он не может подписывать программное обеспечение.

4. Подключите ассистента

Используйте абсолютный путь к исполняемому файлу.

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Code использует тот же исполняемый файл:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

Транспорт — JSON-RPC с разделителями строк через stdio. Сервер не открывает TCP-прослушиватель.

Архитектура

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

Один исполняемый файл выполняет роли сервера MCP и ретранслятора нативного хоста. Управление браузером принадлежит MCP, потому что ему нужны вызываемые инструменты, результаты в виде изображений, защищённый IPC и постоянное состояние сеанса. Навык может добавлять рабочие процессы, но не заменяет сервер.

Модель безопасности

Полное управление — это большая сила. Chrome Control MCP закрепляет происхождение расширения, ограничивает и проверяет IPC, аутентифицирует ретранслятор того же пользователя/того же исполняемого файла, отклоняет устаревшие ссылки на элементы и координаты скриншотов, ограничивает основные полезные нагрузки и предоставляет строгие схемы.

Windows использует именованный канал, защищённый ACL текущего пользователя. Linux и macOS используют Unix-сокет с режимом 0600 в приватном каталоге выполнения плюс учётные данные однорангового узла операционной системы.

Для режима только просмотра:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

Профиль только для чтения предоставляет 10 инструментов и независимо отклоняет скрытые изменяющие вызовы.

Верификация

Локальные шлюзы Windows и Linux в настоящее время охватывают:

• 9/9 нативных и расширенческих наборов с MSVC, GCC и Clang

• Предупреждения как ошибки плюс clang-tidy и исчерпывающий cppcheck

• Отдельные запуски ASan+UBSan и TSan

• Полное сканирование истории Gitleaks и аудит зависимостей npm

• 43/43 живых инструмента MCP через реальный Chrome на Windows

• Навигация по публичному UI Playground, снимок, ввод текста, клик и захват PNG

• Обратимый жизненный цикл установки/статуса/удаления нативного хоста

GitHub Actions собирает и тестирует Windows, Linux и macOS при каждом прямом push.

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

Живая проверка публичного сайта в PowerShell:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

См. точные доказательства и границы утверждений.

Идентичность проекта

Удалите нативный хост текущего пользователя с помощью npm run extension -- uninstall, затем удалите распакованное расширение вручную из chrome://extensions при выводе его из эксплуатации.

Лицензия

Выпущено под лицензией MIT. Авторское право © 2026 Randy Northrup.