browser-tools-mcp

Постоянное управление headed-браузером Chromium для OpenCode/Claude Code, в стиле браузерного инструмента Claude Code. Создано 2026-08-05, потому что в OpenCode не было встроенного браузерного инструмента, а custom-scraper (обычный HTTP) не может читать страницы с тяжёлым JS или требующие входа.

Архитектура

Процесс MCP-сервера является синглтон-менеджером браузера. Поскольку OpenCode поддерживает stdio-сервер активным в течение всей CLI-сессии, браузер сохраняется между ходами агента. Если браузер падает или окно закрывается, следующий вызов инструмента незаметно перезапускает его (server/browser.js).

Конфигурация запуска: headless: false, slowMo: 100, вьюпорт 1280x800, десктопный UA Chrome, --disable-blink-features=AutomationControlled.

Related MCP server: chrome-mcp

Файлы

• server/server.js — точка входа MCP, регистрирует пять инструментов + схемы.

• server/browser.js — синглтон-менеджер браузера/контекста/страницы + логика перезапуска.

• server/tools.js — операции (дерево интерактивных элементов, таргетинг, подсветка, скриншоты).

• server/_self_verify.js — автономный сценарный тест: npm run verify.

• shots/ — скриншоты из browser_inspect.

• USAGE.md — правила для агента (подключены в instructions OpenCode).

Инструменты

Таргетинг элементов соответствует соглашению Claude Code: browser_inspect присваивает каждому интерактивному элементу числовой target, помечая его в DOM как data-bt-target, чтобы последующие действия находили тот же самый элемент (индексы, отфильтрованные по видимости, смещались бы относительно нефильтрованного .nth() на страницах со скрытыми полями ввода). Перед кликом элементы ненадолго подсвечиваются, чтобы пользователь видел действие.

Проверка

npm run verify        # navigate -> inspect -> click -> fill -> crash-recovery

Проверено 2026-08-05: переход/инспекция/клик на example.com, заполнение Google по target и перезапуск после убийства процесса — всё проходит; все пять инструментов зарегистрированы и отвечают по реальному MCP stdio-протоколу.

Эксплуатационные заметки

• Headed означает рабочий стол. Окну Chromium для запуска нужна интерактивная сессия; на headless- или отключённой от дисплея машине запуск не удастся — сообщите об этом, а не делайте вид.

• Изолированный браузер. Это НЕ залогиненный Chrome Luigi (это chrome-bridge). Никаких залогиненных сессий, никаких расширений, полный доступ на запись.

• Требует участия человека. Никаких входов/заказов/отправок без явной инструкции; browser_request_human означает СТОП, пока человек не ответит.

• Зарегистрирован в ~/.config/opencode/opencode.jsonc как MCP-сервер browser-tools; правила использования подключены в instructions через USAGE.md.