auto-browser

auto-browser — MCP-сервер сообщества (автор — LvcidPsyche). Браузерный агент с перехватом управления человеком через noVNC, профилями входа и аудитом. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
LvcidPsyche
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
linux, macos, windows
Языки
python

Уровень риска: high

Управляет настоящим браузером с сохранёнными входами в аккаунты; токен обязателен, ALLOWED_HOSTS, подтверждения и перехват человеком.

Настройка клиентов

codex
{
    "code": "export AUTO_BROWSER_TOKEN=\"$(cat data/api-token)\"\ncodex mcp add auto-browser --url http://127.0.0.1:8000/mcp --bearer-token-env-var AUTO_BROWSER_TOKEN",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Auto Browser — MCP-сервер для управления браузером в разрешённых сценариях, с возможностью для человека вмешаться в любой момент. Он даёт MCP-клиентам, агентам и операторам общий браузер на Playwright. В нём есть перехват управления человеком, сохраняемые профили авторизации, подтверждение действий, журнал аудита и локальное развёртывание.

Что даёт по README:

  • Управление браузером: сессии на Playwright со скриншотами, сводкой DOM, распознанным текстом, вкладками, загрузками и просмотром сетевых запросов;
  • Перехват управления: через noVNC человек подключается к той же живой сессии, если сайт «сломался» или нужно вмешательство;
  • Однократный вход: именованные профили авторизации, из которых открываются новые сессии, уже вошедшие в аккаунт;
  • Защита: подтверждение действий, идентификация оператора, удаление персональных данных, подписанные квитанции Witness (Ed25519), готовые профили политик;
  • Подключение: MCP по HTTP на http://127.0.0.1:8000/mcp, stdio-мост (uvx auto-browser-mcp) и REST;
  • Профили инструментов: curated (20 инструментов, по умолчанию), lean (7) и full. Выбирается переменной MCP_TOOL_PROFILE.

Решение капчи, несанкционированный парсинг и обход защит авторы прямо называют не целью проекта.

Кому подойдёт

  • Внутренние панели и админки, где агенту нужен настоящий браузер, а не загрузка HTML.
  • QA с участием оператора и отладка в браузере.
  • Работа в аккаунтах по схеме «вошёл один раз — пользуешься дальше».
  • Нестабильные сайты, где человеку иногда приходится восстанавливать сценарий вручную.

Похожие серверы — в категории браузер и парсинг.

Установка

Нужен Docker с Compose:

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

При первом запуске контроллер создаёт API-токен и сохраняет его в data/api-token. Каждый запрос к API и MCP должен передавать его в заголовке Authorization. Адреса после запуска:

  • документация API — http://127.0.0.1:8000/docs;
  • панель оператора с очередью действий на подтверждение — http://127.0.0.1:8000/dashboard;
  • перехват управления — http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale.

Все порты по умолчанию открыты только на 127.0.0.1.

Подключение к клиентам

Команды приведены дословно из README. Их нужно выполнить из папки auto-browser. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http --scope user auto-browser http://127.0.0.1:8000/mcp \
  --header "Authorization: Bearer $(cat data/api-token)"

Codex берёт токен из переменной окружения, поэтому экспортируйте её там, где он запускается. Cursor, VS Code и Claude Desktop (через stdio-мост) описаны в docs/mcp-clients.md репозитория.

Проверка

Выполните make doctor в обычном терминале с доступом к Docker. Затем откройте панель оператора, вставьте токен и попросите агента создать сессию на https://example.com и сделать скриншот.

Примеры задач

Открой внутреннюю админку, найди заказ по номеру и сделай скриншот карточки.
Пройди сценарий регистрации на тестовом стенде и сообщи, где он ломается.

Риски

Агент управляет настоящим браузером и может действовать в аккаунтах, вход в которые сохранён в профилях авторизации: отправлять формы, менять данные, скачивать файлы. Защита по README:

  • токен обязателен. Режим API_ALLOW_TOKENLESS_LOOPBACK=true отключает его, и тогда браузером может управлять любой контейнер в сети compose;
  • ALLOWED_HOSTS ограничивает сайты, куда браузер может переходить. Iframe и подресурсы других хостов этим не покрываются;
  • по умолчанию все сессии делят один Chromium и один рабочий стол noVNC: оператор, перехвативший одну сессию, видит окна остальных. Для изоляции есть режим docker_ephemeral;
  • для реального развёртывания README перечисляет обязательные переменные: шифрование профилей авторизации, идентификатор оператора, лимиты запросов. Предустановки COMPLIANCE_TEMPLATE=strict и balanced требуют подтверждать загрузки.

Храните data/api-token как пароль и не открывайте порты наружу без TLS и настроек из раздела безопасности README.

Частые вопросы

Решает ли Auto Browser капчу?

Нет, решение капчи и обход защит прямо исключены из целей проекта.

Можно ли вмешаться в работу агента?

Да, через noVNC человек подключается к той же живой сессии и может продолжить вручную.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

browser-use

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники