Firefox DevTools MCP

Serveur Model Context Protocol qui permet aux agents IA d'utiliser Firefox. Il a deux cas d'usage principaux :

• Navigation agentique : l'agent utilise le navigateur pour des tâches courantes, comme lire des pages, remplir des formulaires et suivre des parcours à plusieurs étapes sur des sites web.
• Développement web assisté par agent : l'agent charge la page sur laquelle vous travaillez et l'inspecte avec les outils de développement, comme la console, les requêtes réseau, le débogueur et le profileur.

Il contrôle Firefox via WebDriver BiDi (par l'intermédiaire de Selenium WebDriver) et fonctionne avec Claude Code, Claude Desktop, Cursor, Cline et d'autres clients MCP.

Dépôt : https://github.com/mozilla/firefox-devtools-mcp

Remarque : ce serveur MCP nécessite une installation locale du navigateur Firefox et ne peut pas fonctionner sur des services d'hébergement cloud comme glama.ai. Utilisez npx @mozilla/firefox-devtools-mcp@latest pour l'exécuter localement, ou utilisez Docker avec le Dockerfile fourni.

Sécurité

Les serveurs MCP de navigateur comportent des risques inhérents. Quelques pratiques essentielles :

• Utilisez un profil Firefox dédié. N'exécutez jamais le serveur avec votre profil habituel — l'agent a accès à tout ce que le navigateur peut atteindre, y compris les cookies et les sessions enregistrées.
• Soyez prudent quant aux sites que vous visitez. Les pages peuvent renvoyer du contenu conçu pour manipuler l'agent (injection de prompt). Limitez-vous aux sites que vous contrôlez ou auxquels vous faites confiance.
• N'activez que les modules d'outils dont vous avez besoin. Le préréglage par défaut basic inclut déjà evaluate_script ; --tool-preset slim le retire. Les préréglages plus élevés tels que --tool-preset developer (débogage, réseau, console, profileur) et --tool-preset mozilla (contexte privilégié) étendent encore davantage ce que l'agent peut faire.

Consultez SECURITY.md pour une description complète des risques et pour savoir comment signaler des vulnérabilités.

Prérequis

• Node.js ≥ 20.19.0
• Firefox 100+ installé (détecté automatiquement, ou passez --firefox-path)

Installation et utilisation avec Claude Code ou Codex (npx)

Recommandé : utilisez npx afin d'exécuter la dernière version publiée sur npm.

Option 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

Option B — Modifier le fichier de configuration

Claude Code

Ajoutez à mcp_settings.json de Claude Code :

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

Codex

Ajoutez à ~/.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"

Option C — Script utilitaire (build de développement local)

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

Essayez-le avec MCP Inspector

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

Appelez ensuite des outils comme :

• list_pages, select_page, navigate_page
• take_snapshot puis click_by_uid / fill_by_uid
• list_network_requests (capture toujours active), get_network_request
• list_downloads (capture toujours active), set_download_behavior
• screenshot_page, list_console_messages

Options CLI

Vous pouvez passer des flags ou des variables d'environnement (noms à droite) :