Better AI Browser Utilities (BABU)

Эффективное по токенам управление MCP для уже используемой вами сессии Chrome — вкладки, куки, логины и всё остальное. BABU подключает любого MCP-совместимого агента к локальному расширению Chrome вместо запуска отдельного профиля автоматизации.

Почему BABU

• Четыре компактные MCP-схемы по умолчанию вместо двадцати повторяющихся инструментов браузера.

• Прогрессивное раскрытие: browser_read возвращает ограниченный текст и компактные элементы управления; browser_help показывает детали команд только по запросу.

• Быстрые действия: browser_do обрабатывает навигацию, клики, ввод текста, клавиши, прокрутку, ожидания, скриншоты, JavaScript и загрузку файлов через loopback.

• Реальное состояние браузера: использует ваши существующие вкладки Chrome и аутентифицированные сессии.

• Портативность: установка напрямую из GitHub с помощью uvx; каждый документированный клиент использует стандартный MCP stdio.

• Локальность: единственный сетевой слушатель привязан к 127.0.0.1; WebSocket расширения требует сгенерированный токен сопряжения.

Опубликованные схемы MCP v2 занимают 567 токенов в компактном режиме против 2 219 для устаревшего набора из двадцати инструментов: на 74,45% меньше контекста схемы на каждый ход модели (o200k_base, канонический JSON, без учёта клиентской обвязки).

Архитектура

MCP client
   |  stdio (client-owned subprocess)
   v
BABU Python bridge
   |  authenticated WebSocket ws://127.0.0.1:8765
   v
BABU Chrome extension (MV3) -> your real Chrome tabs

Установка

Предварительные требования: uv и Chrome 116 или новее.

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup

Команда экспортирует встроенное расширение в ~/.babu/extension, создаёт ~/.babu/token и один раз выводит токен для сопряжения.

В Chrome:

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

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

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

4. Откройте расширение BABU, вставьте токен сопряжения и нажмите Сохранить.

Стабильный Chrome больше не принимает автоматическую установку через --load-extension, поэтому требуется однократная ручная загрузка.

Добавление BABU в MCP-клиент

Используйте это определение запуска через stdio:

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0",
    "babu",
    "mcp"
  ]
}

Точные команды и файлы конфигурации для Hermes, Codex, Claude Code, Cursor, VS Code, Zed, ZCode, Gemini CLI, OpenCode, Cline, Windsurf, Pi и Agent Prime находятся в docs/CLIENTS.md.

Только один процесс BABU может владеть портом WebSocket 8765 одновременно. Закройте другой BABU-совместимый харнесс перед запуском нового.

Инструменты MCP

Команды browser_do:

list_tabs, get_active_tab, open_tab, close_tab, activate_tab, navigate,
get_state, snapshot, click, hover, type, select, press, scroll, extract_text, screenshot,
eval, upload_files, wait_for, back, forward, reload

Рекомендуемый порядок действий:

1. Вызовите browser_read с релевантным query.

2. Передайте возвращённый индекс элемента в browser_do с click или type.

3. Повторно читайте после навигации или значительных изменений DOM, так как индексы локальны для документа.

4. Используйте browser_help только когда параметры команды неясны.

Скриншоты по умолчанию сохраняются в системную временную директорию; байты изображения в base64 исключаются из контекста модели, если явно не указано include_data_url=true.

Утилиты CLI

babu setup [--force]            # export/update extension and create token
babu token                      # print the current pairing token
babu mcp                        # stdio MCP server, compact profile
babu relay list_tabs            # direct browser command without an MCP client
babu relay navigate '{"url":"https://example.com"}'

babu relay полезен для минимальных харнессов, предпочитающих CLI-инструменты вместо MCP.

Профили инструментов

• compact (по умолчанию): четыре инструмента выше.

• legacy: двадцать прямых инструментов браузера для клиентов, предпочитающих одну схему на действие.

• all: обе поверхности.

Выберите профиль с помощью --tool-profile compact|legacy|all или BABU_TOOL_PROFILE.

Безопасность

BABU управляет вошедшим в систему профилем браузера, поэтому относитесь к нему как к мощному локальному инструменту.

• Слушатель WebSocket привязан только к 127.0.0.1; MCP передаётся через stdio.

• Проверяются источники расширения Chrome и роли клиентов.

• Канал расширение-мост использует 256-битный токен, хранящийся в ~/.babu/token.

• Всплывающее окно расширения может немедленно отключить всё управление.

• Поля паролей, OTP и платежей редактируются при обычном чтении.

• browser_eval по замыслу выполняет JavaScript в основном мире страницы.

• Загрузка файлов принимает только ограниченные прямые loopback HTTP(S) URL без учётных данных.

Проверяйте каждый вызов инструмента MCP и используйте средства контроля одобрения каждого клиента.

Ограничения

• Внутренние страницы Chrome, Web Store, просмотрщик PDF, выгруженные вкладки и элементы внутри iframe или shadow root не могут быть управляемы.

• Строгая CSP страницы может блокировать browser_eval; инструменты чтения/кликов/ввода DOM всё равно работают.

• browser_press поддерживает Enter, Tab и синтетический Escape; для текста используйте browser_type.

• Распакованное расширение необходимо перезагружать из chrome://extensions после обновления.

• Сервер по замыслу рассчитан на одного клиента и одно расширение браузера.

Обновление

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup --force

Перезагрузите BABU на chrome://extensions, затем перезапустите MCP-клиент. Измените Git-тег в конфигурации клиента при переходе на новую версию.

Лицензия

MIT