Firefox DevTools MCP

Model Context Protocol-Server, mit dem KI-Agenten Firefox nutzen können. Er hat zwei Hauptanwendungsfälle:

• Agentisches Browsen: Der Agent nutzt den Browser für reguläre Aufgaben, etwa zum Lesen von Seiten, Ausfüllen von Formularen und Durchlaufen mehrstufiger Abläufe auf Websites.
• Agentenunterstützte Webentwicklung: Der Agent lädt die Seite, an der Sie arbeiten, und untersucht sie mit Entwicklerwerkzeugen wie der Konsole, Netzwerkanfragen, dem Debugger und dem Profiler.

Er steuert Firefox über WebDriver BiDi (via Selenium WebDriver) und funktioniert mit Claude Code, Claude Desktop, Cursor, Cline und anderen MCP-Clients.

Repository: https://github.com/mozilla/firefox-devtools-mcp

Hinweis: Dieser MCP-Server erfordert eine lokale Firefox-Browser-Installation und kann nicht auf Cloud-Hosting-Diensten wie glama.ai ausgeführt werden. Verwenden Sie npx @mozilla/firefox-devtools-mcp@latest, um ihn lokal auszuführen, oder nutzen Sie Docker mit dem bereitgestellten Dockerfile.

Sicherheit

Browser-MCP-Server bergen inhärente Risiken. Einige wichtige Praktiken:

• Verwenden Sie ein dediziertes Firefox-Profil. Führen Sie den Server niemals mit Ihrem regulären Profil aus — der Agent hat Zugriff auf alles, was der Browser erreichen kann, einschließlich Cookies und gespeicherter Sitzungen.
• Seien Sie vorsichtig bei den Websites, die Sie besuchen. Seiten können Inhalte zurückgeben, die darauf ausgelegt sind, den Agenten zu manipulieren (Prompt-Injection). Bleiben Sie bei Websites, die Sie kontrollieren oder denen Sie vertrauen.
• Aktivieren Sie nur die benötigten Tool-Module. Das Standard-Preset basic enthält bereits evaluate_script; --tool-preset slim entfernt es. Höhere Presets wie --tool-preset developer (Debugging, Netzwerk, Konsole, Profiler) und --tool-preset mozilla (privilegierter Kontext) erweitern die Möglichkeiten des Agenten weiter.

Siehe SECURITY.md für eine vollständige Aufschlüsselung der Risiken und Informationen zum Melden von Schwachstellen.

Voraussetzungen

• Node.js ≥ 20.19.0
• Firefox 100+ installiert (automatisch erkannt oder über --firefox-path angeben)

Installation und Verwendung mit Claude Code oder Codex (npx)

Empfohlen: Verwenden Sie npx, damit Sie die neueste veröffentlichte Version von npm ausführen.

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 — Konfigurationsdatei bearbeiten

Claude Code

Zu den mcp_settings.json von Claude Code hinzufügen:

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

Codex

Füge zu ~/.codex/config.toml hinzu:

[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 — Hilfsskript (lokaler Dev-Build)

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

Mit MCP Inspector ausprobieren

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

Rufen Sie dann Tools auf wie:

• list_pages, select_page, navigate_page
• take_snapshot und dann click_by_uid / fill_by_uid
• list_network_requests (immer aktive Erfassung), get_network_request
• list_downloads (immer aktive Erfassung), set_download_behavior
• screenshot_page, list_console_messages

CLI-Optionen

Sie können Flags oder Umgebungsvariablen übergeben (Namen rechts):