Firefox DevTools MCP

Сервер Model Context Protocol, который позволяет ИИ-агентам использовать Firefox. У него два основных сценария применения:

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

Он управляет Firefox через WebDriver BiDi (посредством Selenium WebDriver) и работает с Claude Code, Claude Desktop, Cursor, Cline и другими MCP-клиентами.

Репозиторий: https://github.com/mozilla/firefox-devtools-mcp

Примечание: этому MCP-серверу требуется локально установленный браузер Firefox, и он не может работать на облачных хостинговых сервисах, таких как glama.ai. Используйте npx @mozilla/firefox-devtools-mcp@latest для локального запуска или Docker с предоставленным Dockerfile.

Безопасность

MCP-серверы для браузеров несут в себе неотъемлемые риски. Несколько ключевых практик:

• Используйте отдельный профиль Firefox. Никогда не запускайте сервер с вашим обычным профилем — агент имеет доступ ко всему, до чего может добраться браузер, включая cookie и сохранённые сессии.
• Будьте осторожны с сайтами, которые вы посещаете. Страницы могут возвращать контент, созданный для манипулирования агентом (prompt injection). Придерживайтесь сайтов, которые вы контролируете или которым доверяете.
• Включайте только те модули инструментов, которые вам нужны. Пресет по умолчанию basic уже включает evaluate_script; --tool-preset slim убирает его. Более высокие пресеты, такие как --tool-preset developer (отладка, сеть, консоль, профилировщик) и --tool-preset mozilla (привилегированный контекст), ещё больше расширяют возможности агента.

Полный разбор рисков и инструкции по сообщению об уязвимостях см. в SECURITY.md.

Требования

• Node.js ≥ 20.19.0
• Установленный Firefox 100+ (определяется автоматически или укажите --firefox-path)

Установка и использование с Claude Code или Codex (npx)

Рекомендуется: используйте npx, чтобы запускать последнюю опубликованную версию из npm.

Вариант A — CLI

Claude Code

claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest

# Headless + viewport via args
claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# Or via environment variables
claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest \
  --env START_URL=https://example.com \
  --env FIREFOX_HEADLESS=true

Codex

codex mcp add firefox-devtools -- npx @mozilla/firefox-devtools-mcp@latest

# Headless + viewport via args
codex mcp add firefox-devtools -- \
  npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# Or via environment variables
codex mcp add firefox-devtools \
  --env START_URL=https://example.com \
  --env FIREFOX_HEADLESS=true \
  -- npx @mozilla/firefox-devtools-mcp@latest

Вариант B — редактирование файла конфигурации

Claude Code

Добавьте в файл mcp_settings.json Claude Code:

{
  "mcpServers": {
    "firefox-devtools": {
      "command": "npx",
      "args": ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"],
      "env": {
        "START_URL": "about:blank"
      }
    }
  }
}

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.firefox-devtools]
command = "npx"
args = ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"]

[mcp_servers.firefox-devtools.env]
START_URL = "about:blank"

Вариант C — вспомогательный скрипт (локальная dev-сборка)

npm run setup
# Choose Claude Code; the script saves JSON to the right path

Попробуйте с MCP Inspector

npx @modelcontextprotocol/inspector npx @mozilla/firefox-devtools-mcp@latest --start-url https://example.com --headless

Затем вызывайте инструменты, например:

• list_pages, select_page, navigate_page
• take_snapshot, затем click_by_uid / fill_by_uid
• list_network_requests (постоянный захват), get_network_request
• list_downloads (постоянный захват), set_download_behavior
• screenshot_page, list_console_messages

Параметры CLI

Можно передавать флаги или переменные окружения (имена справа):