Firefox DevTools MCP
MCP-сервер от Mozilla: агент управляет Firefox через WebDriver BiDi, читает консоль и сеть, делает снимки страниц и профилирует загрузку
- 515 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент действует в браузере от вашего имени и видит куки и сохраненные сессии профиля
- Инструмент evaluate_script в пресете по умолчанию выполняет JavaScript на открытых страницах
- Страницы внешних сайтов могут подсунуть агенту инструкции, а режим Android стирает данные приложения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/firefox-devtools-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент действует в браузере от вашего имени и видит куки и сохраненные сессии профиля
- Инструмент evaluate_script в пресете по умолчанию выполняет JavaScript на открытых страницах
- Страницы внешних сайтов могут подсунуть агенту инструкции, а режим Android стирает данные приложения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту управлять настоящим Firefox через WebDriver BiDi с помощью Selenium. Работа идет в двух сценариях. В первом агент ходит по сайтам как пользователь: читает страницы, заполняет формы, проходит многошаговые сценарии. Во втором он открывает вашу страницу под разработку и смотрит ее инструментами разработчика: консоль, сетевые запросы, отладчик и профилировщик. Агент сначала делает снимок страницы командой take_snapshot, получает идентификаторы элементов и дальше работает с ними: click_by_uid, fill_by_uid. Список сетевых запросов и загрузок собирается постоянно, консоль читается через list_console_messages, скриншот делает screenshot_page. Громоздкий вывод можно сохранить в файл параметром saveTo, чтобы не занимать контекст агента. Набор инструментов задается пресетом: slim, basic по умолчанию, developer, mozilla и all. Для Claude Code есть готовый плагин с навыками browser-automation, navigate, debug, screenshot и web-performance и двумя субагентами, e2e-tester и web-extractor.
Для кого. Для веб-разработчиков и тестировщиков, которым нужно проверить сайт в Firefox из Claude Code, Codex, Cursor или Cline.
Подходит, если
- Верстка ведет себя в Firefox иначе, чем в Chrome, и нужно посмотреть консоль, сетевые запросы и снимок страницы глазами агента
- Требуется прогнать сценарий входа: агент заполнит форму, отправит ее и сообщит, где упал запрос
- Нужно профилировать загрузку страницы и разобрать результат по плейбуку навыка web-performance
- Надо автоматизировать Firefox for Android: сервер запускает его на устройстве через adb
- Хочется сохранить большой лог сети в файл и разобрать его позже, не засоряя контекст агента
Не подходит, если
- Нужен Chrome: сервер управляет только Firefox, для Chrome в каталоге есть chrome-devtools-mcp
- Нужен облачный запуск: серверу требуется локальный Firefox, он не работает на облачных хостингах вроде glama.ai
- Вы собираетесь пускать агента на чужие и непроверенные сайты с основным профилем: страница может подсунуть агенту инструкции
- На машине стоит Node.js ниже 20.19 или Firefox ниже 100
- Достаточно разового скриншота: проще открыть страницу и сохранить его самому
Пример запроса к агенту
Открой localhost:3000 в Firefox, сделай снимок страницы, покажи ошибки консоли и сетевые запросы со статусом 4xx и 5xx, затем сохрани скриншотMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
START_URL- Адрес, который открывается при запуске
FIREFOX_HEADLESS- Значение true запускает Firefox без окна
TOOL_PRESET- Пресет инструментов: slim, basic, developer, mozilla или all
Ограничения
Нужны Node.js 20.19 и новее и Firefox 100 и новее, путь к браузеру определяется сам или задается флагом --firefox-path. Плагин для Claude Code включает инструменты скриптов, которым нужен Firefox 153 или новее, а без них хватает Firefox 120.
Пресет basic по умолчанию содержит evaluate_script, то есть выполнение JavaScript на странице. Чтобы убрать его, запустите сервер с --tool-preset slim. Модули prefs, privileged, launch и bidi есть только во внутренней сборке Mozilla: публичный пакет пропускает их, даже если их запросить. Версия пока 0.x.
Режим Android стирает все данные целевого приложения перед каждой сессией, поэтому требует флага --android-wipe-app-data и отдельной сборки браузера для автоматизации. Режим --connect-existing включает Marionette, из-за чего navigator.webdriver становится true и сайты с защитой от ботов могут реагировать. Доступность из России автор не описывает.
Как отключить. Удалите сервер командой claude mcp remove firefox-devtools или уберите запись из конфигурации клиента. Плагин снимается через меню /plugin. Отдельный профиль Firefox, созданный для агента, можно стереть, он лежит во вложенной папке firefox_devtools_mcp_profile.
Частые вопросы
Как подключить Firefox к Claude Code через MCP?
Выполните claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest. Добавьте -- --headless --viewport 1280x720, если окно браузера не нужно, или задайте START_URL и FIREFOX_HEADLESS через --env. Для Codex команда та же, но начинается с codex mcp add.
Чем Firefox DevTools MCP отличается от chrome-devtools-mcp?
Он управляет Firefox через WebDriver BiDi и Selenium, тогда как chrome-devtools-mcp работает с Chrome. Выбирайте этот сервер, когда сайт нужно проверить в Firefox, включая Firefox for Android.
Безопасно ли давать агенту основной профиль Firefox?
Нет. Агент получает доступ ко всему, что видит браузер, включая куки и сохраненные сессии. Mozilla советует отдельный профиль, ограничение набора инструментов и осторожность с сайтами, чьи страницы могут манипулировать агентом.
Что означают пресеты инструментов?
Пресеты slim, basic, developer, mozilla и all образуют вложенный ряд, каждый шире предыдущего. Basic по умолчанию содержит evaluate_script, developer добавляет сеть, консоль, отладку и профилировщик. Явный список модулей флагом --tools перекрывает пресет.
Можно ли подключиться к уже запущенному Firefox?
Да, флагом --connect-existing. Firefox нужно запустить с --marionette и --remote-debugging-port. После работы перезапустите браузер в обычном режиме, потому что Marionette меняет сигналы отпечатка и может вызывать антибот-защиту.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, агент и скиллы для сквозных UI-тестов: агент управляет компьютером через компьютерное зрение на облачных машинах
MCP-сервер, который запускает несколько браузерных агентов и проверяет сайт на битые ссылки, ошибки интерфейса и доступность
Один бинарник для автоматизации браузера агентом: CLI со скиллами browser и check, MCP-сервер и клиенты для JS, Python и Java
MCP-сервер на Playwright от сообщества: браузерная автоматизация, скриншоты, эмуляция устройств и генерация тестового кода
Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Firefox DevTools MCP (эта запись) | да | не нужна | 515 | |
| Chrome DevTools MCP | да | не нужна | 54 001 | тот же замысел для браузера Chrome |
| Playwright MCP | да | не нужна | 38 513 | автоматизация браузеров через Playwright, без привязки к инструментам разработчика Firefox |
Коротко о README
Документ начинается с двух сценариев применения и предупреждений о безопасности: отдельный профиль, осторожность с сайтами и выбор модулей. Дальше идут требования, установка для Claude Code и Codex командой или правкой конфигурации, запуск через MCP Inspector и таблица флагов. Отдельные разделы объясняют пресеты инструментов, режим Android с полным стиранием данных приложения, подключение к работающему Firefox и сохранение объемного вывода в файл. В конце собраны советы по неполадкам, в том числе обход проблемы запуска npx в Windows 10.