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, подтверждения и перехват человеком.
Настройка клиентов
{
"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
Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.
Fetch
Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.
Chrome DevTools MCP
Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.
browser
Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.