Browser Bridge

AI ↔ мост управления браузером: превращает браузер в набор инструментов MCP. Любой MCP-клиент (AI-программа) через стандартный протокол MCP вызывает такие инструменты, как browser_snapshot / browser_click / browser_type, и управляет веб-страницами в реальном браузере.

• Поддерживает любой MCP-клиент: Claude, codex, пользовательский агент, curl

• По умолчанию режим следования: AI автоматически управляет вашей текущей активной вкладкой, нулевая настройка

• Реальный браузер, не headless: состояние входа, капча (подскажет вам вручную), естественные признаки защиты от парсинга

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

1. Загрузка

Скачайте один архив из Releases:

• browser-bridge-<platform>-<arch>.zip — выберите по платформе вашей машины

Распакуйте в любую директорию (далее <DIR>), внутри будут browser-bridge/ (расширение), browser-bridge-host, install-host.sh (для Windows — install-host.ps1).

2. Загрузка расширения

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

2. В правом верхнем углу включите режим разработчика

3. Нажмите «Загрузить распакованное расширение» и выберите распакованную директорию browser-bridge/

3. Установка host

macOS / Linux:

cd <DIR>
./install-host.sh         # Windows(PowerShell): .\install-host.ps1

После запуска будут перечислены обнаруженные браузеры; нажмите Enter для установки во все, или введите номер для выбора конкретного браузера; также поддерживается прямое указание параметров:

./install-host.sh --all      # 安装到全部浏览器
./install-host.sh --chrome   # 只装 Chrome(--chromium / --edge 同理)

ID расширения уже встроен фиксированно, вручную заполнять не нужно; если ваш ID расширения отличается, можно добавить параметр: ./install-host.sh <ваш ID расширения>.

Если браузер уже открыт, после установки полностью закройте и перезапустите браузер.

4. Использование

Подключение любого MCP-клиента:

MCP server: http://127.0.0.1:1234/mcp

При занятом порте автоматически +1, фактический порт смотрите в popup расширения (Подключено · MCP порт xxxx) или в ~/.browser-bridge/port.

Пример конфигурации codex (~/.codex/config.toml):

[mcp_servers.browser]
url = "http://127.0.0.1:1234/mcp"

После этого скажите AI «посмотри на эту страницу…» — и всё.

Related MCP server: BrowserPilot

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

AI сам оркестрирует: snapshot → решение → действие → снова snapshot, пока задача не выполнена.

Режимы управления

• Режим следования (по умолчанию): управляет вашей текущей активной вкладкой, переключение вкладки меняет цель

• Режим фиксации: блокирует определённую вкладку (переключение не следует); в popup можно закрепить/открепить одной кнопкой, или AI вызывает browser_use_tab

Значки на панели инструментов: нет = следование; AI янтарный = закреплено; ! красный = ошибка подключения.

Архитектура

任意 MCP 客户端
   │ MCP (Streamable HTTP, 127.0.0.1:1234/mcp)
browser-bridge host(单进程 = MCP ↔ 帧协议翻译器)
   │ native messaging(stdin/stdout 帧)
Chrome 扩展
   ├─ background:转发、目标解析、保活、状态徽标
   └─ content script:快照 / 执行

Расширение MV3 не может прослушивать порты, native host — единственный канал (аналогично официальному DevTools MCP от Chrome).

Сборка из исходников (для разработчиков)

Требуется bun:

bun install
bun run build                    # 当前平台 host + 扩展
./scripts/install-host.sh        # 注册 host(默认内置扩展 ID)
bun run scripts/build.ts --all   # 交叉编译全部平台 + 发布包(发布用)
bun test                         # 单元 + MCP API 集成测试(无需浏览器)

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

• BROWSER_BRIDGE_PORT: начальный порт MCP (по умолчанию 1234, при занятости автоматически +1)

• BROWSER_BRIDGE_MOCK=1: имитация ответа расширения (для разработки и тестирования)

Устранение неполадок

Лицензия

MIT