Browser Navigator MCP

Сервер Model Context Protocol (MCP), который предоставляет AI-ассистентам полный контроль над браузером Brave через CDP (Chrome DevTools Protocol). Создан для OSINT-расследований, парсинга социальных сетей и общей веб-автоматизации.

Подключается к вашему существующему экземпляру Brave (или запускает новый), не затрагивая ваши вкладки — он подключается к браузеру, а не создаёт его клон.

Возможности

• 🧭 Полный контроль над браузером — навигация, клики, ввод текста, наведение, скриншоты, экспорт в PDF

• 🪟 Управление окнами и вкладками — список, открытие, переключение и закрытие окон/вкладок

• 🔐 Обнаружение CAPTCHA — автоматически определяет reCAPTCHA, hCaptcha, Cloudflare Turnstile и другие проверки, затем ждёт, пока человек их решит

• 🍪 Сохранение сессий — сохранение и загрузка куки для поддержания входа между запусками

• 🎥 Управление видео — воспроизведение/пауза/перемотка/громкость на любом HTML5-плеере (YouTube и др.)

• 🔍 Поиск по соцсетям — один инструмент для поиска в Google, X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube

• 🔧 Произвольный JavaScript — execute_js для любых других задач (с явным подтверждением)

• 🏥 Проверка состояния — подтверждение состояния сервера и подключения к браузеру

Требования

• Node.js 20+

• Браузер Brave (установлен в стандартном месте или укажите путь через BRAVE_PATH)

• Загрузка Playwright не требуется — сервер управляет Brave напрямую через CDP

Установка

git clone <your-repo-url>
cd brave-browser-mcp
npm install

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

1. Запустите Brave с отладочным портом

./launch-brave.sh

Это запускает Brave с --remote-debugging-port=9222. Сервер никогда не завершает существующий экземпляр Brave — если порт 9222 уже занят, он просто оставляет его как есть.

Альтернативно, запустите Brave вручную: brave --remote-debugging-port=9222. Если Brave уже запущен без отладочного порта, MCP попросит вас закрыть его и повторить попытку — он не будет принудительно завершать ваш работающий браузер.

2. Запустите сервер

node index.js

Сервер общается через MCP по stdio. connect_brave автоматически подключается к запущенному экземпляру Brave.

3. Зарегистрируйте его как MCP-сервер

Для opencode добавьте в opencode.json:

{
  "mcp": {
    "browser-navigator": {
      "type": "local",
      "command": ["node", "index.js"],
      "cwd": "/absolute/path/to/brave-browser-mcp",
      "enabled": true
    }
  }
}

Для Claude Desktop добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "browser-navigator": {
      "command": "node",
      "args": ["/absolute/path/to/brave-browser-mcp/index.js"]
    }
  }
}

Инструменты

Обработка CAPTCHA

CAPTCHA обнаруживаются автоматически после navigate / navigate_history и отражаются в get_page_info. При обнаружении нерешённой CAPTCHA автоматизация приостанавливается и просит пользователя решить её в браузере — этот инструмент не может (и не будет) их обходить.

Определяемые типы: reCAPTCHA, hCaptcha, Cloudflare Turnstile, Cloudflare Challenge.

Примечания по безопасности

• execute_js требует confirm=true и ограничен выводом в 5000 символов / 50 КБ.

• Пути для скриншотов и куки проверяются на защиту от обхода каталогов.

• Куки сохраняются с правами 0o600, каталоги — с правами 0o700.

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

• Полный аудит безопасности и качества кода — см. AUDIT.md.

Тестирование

Набор тестов запускает сервер через реальный MCP-протокол по stdio (требуется запущенный Brave на порту 9222):

node test.cjs

53 проверки, покрывающие навигацию, CAPTCHA, вкладки, окна, скриншоты, куки, видео и усиление безопасности.

Лицензия

PolyForm Noncommercial 1.0.0 — см. LICENSE.

Разрешено бесплатное использование в некоммерческих целях (личные, исследовательские, образовательные, благотворительные, государственные). Для коммерческого использования свяжитесь с автором — пожалуйста, обратитесь за разрешением перед коммерческим применением этого проекта.