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: Playwright MCP Server

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 — единственный канал (аналогично официальному Chrome DevTools MCP).

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

Требуется 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