AI agent'larının web sitelerinde gezinmesini; konsol, ağ, debugger ve profiler gibi geliştirici araçlarını kullanarak Firefox sayfalarını incelemesini sağlar.
Ayrıca bilinen adı mozilla/firefox-devtools-mcp, firefox-devtools-mcp, @mozilla/firefox-devtools-mcp
- Yıldızlar
- 571
- Araçlar
- 35
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.10.7
- Son commit
- 4 Kas 2026
- Lisans
- —
Firefox DevTools MCP nedir?
AI agent'larının web sitelerinde gezinmesini; konsol, ağ, debugger ve profiler gibi geliştirici araçlarını kullanarak Firefox sayfalarını incelemesini sağlar. 35 araç sunar; örneğin list_pages, new_page, navigate_page.
Özet, projenin README dosyasından oluşturuldu
Firefox DevTools MCP sunucusu hakkında
Web geliştiricileri ve otonom agent'lar, bu MCP server aracılığıyla yerel bir Firefox tarayıcısını kontrol ederek canlı web siteleriyle etkileşime girebilirler. Form doldurma veya çok adımlı web sitesi akışlarında gezinme gibi görevler için agent tabanlı gezinti imkanı sunarken, web geliştirme için derinlemesine inceleme yetenekleri sağlar. Sunucu, WebDriver BiDi kullanarak bir AI istemcisinin konsol, ağ izleyici, debugger ve profiler dahil olmak üzere profesyonel hata ayıklama araçlarına erişmesine olanak tanır.
Kullanıcılar bu sunucuyu npx veya Docker kullanarak yerel olarak çalıştırabilirler; bu da onu Claude Desktop, Claude Code, Cursor ve Cline gibi istemcilerle uyumlu hale getirir. Güvenliği ve işlevselliği yönetmek için slim, basic, developer veya mozilla gibi farklı araç presetlerini seçebilirsiniz. Ayrıca ADB aracılığıyla Android cihazlarda Firefox otomasyonunu da destekler. Gerçek bir tarayıcı ile etkileşime girdiği için, kişisel çerezlerinizi ve kayıtlı oturumlarınızı korumak adına özel bir Firefox profili kullanmanız önerilir.
Neler yapabilirsiniz
- 1Otomatik web navigasyonuBir AI agent, içerik okuma veya çok adımlı kullanıcı akışlarını tamamlama gibi rutin web sitesi görevlerini yerine getirebilir.
- 2Web geliştirme hata ayıklamaGeliştiriciler, sorunları gidermek için profesyonel geliştirici araçlarını kullanarak bir AI'ın canlı bir sayfayı incelemesini sağlayabilir.
- 3Mobil tarayıcı otomasyonuADB ve belirli paket yapılandırmalarını kullanarak bir Android cihazda çalışan Firefox'u otomatize edebilirsiniz.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Firefox DevTools MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleFirefox DevTools MCP'yi Claude Code içine yükleyin
$ claude mcp add firefox-devtools-mcp -- npx -y @mozilla/firefox-devtools-mcpFirefox DevTools MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"firefox-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"@mozilla/firefox-devtools-mcp"
]
}
}
}Firefox DevTools MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"firefox-devtools-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mozilla/firefox-devtools-mcp"
]
}
}
}Firefox DevTools MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"firefox-devtools-mcp","type":"stdio","command":"npx","args":["-y","@mozilla/firefox-devtools-mcp"]}'Firefox DevTools MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"firefox-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"@mozilla/firefox-devtools-mcp"
]
}
}
}Firefox DevTools MCP'yi Codex içine yükleyin
$ codex mcp add firefox-devtools-mcp -- npx -y @mozilla/firefox-devtools-mcpFirefox DevTools MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.firefox-devtools-mcp] command = "npx" args = ["-y", "@mozilla/firefox-devtools-mcp"]
Firefox DevTools MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user firefox-devtools-mcp npx -- -y @mozilla/firefox-devtools-mcpFirefox DevTools MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"firefox-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"@mozilla/firefox-devtools-mcp"
]
}
}
}HostedMCP tarafından 16 Kas 2026 tarihinde başlatıldı
Bu komutu @mozilla/firefox-devtools-mcp 0.10.7 için ağsız ve anahtarsız, yalıtılmış bir konteynerde çalıştırdık. Yanıt verdi ve 35 araç listeledi.
Firefox DevTools MCP araçları 35
Sunucudan tools/list ile okundulist_pagesSalt okunurList open tabs (index, title, URL). Selected tab is marked.
new_pageEylemOpen new tab at URL. Returns tab index.
navigate_pageEylemNavigate selected tab to URL.
select_pageEylemSelect active tab by index, URL, or title. Index takes precedence.
close_pageEylemClose tab by index.
get_page_textSalt okunurGet the visible text of the page (document.body.innerText). Caps at maxLength (default 20000 chars); saveTo saves the full text to a file.
take_snapshotSalt okunurCapture DOM snapshot with stable UIDs. A UID stays valid across snapshots until its element is removed or the page navigates. Output caps at maxLines (default 100); scope with selector or dump the full tree with saveTo.
resolve_uid_to_selectorSalt okunurResolve UID to CSS selector. Fails if the element is gone.
clear_snapshotEylemClear snapshot UIDs. Usually not needed.
click_by_uidEylemClick element by UID. Set dblClick for double-click.
hover_by_uidEylemHover over element by UID.
fill_by_uidEylemFill text input/textarea by UID.
| list_pages | List open tabs (index, title, URL). Selected tab is marked. | Salt okunur |
| new_page | Open new tab at URL. Returns tab index. | Eylem |
| navigate_page | Navigate selected tab to URL. | Eylem |
| select_page | Select active tab by index, URL, or title. Index takes precedence. | Eylem |
| close_page | Close tab by index. | Eylem |
| get_page_text | Get the visible text of the page (document.body.innerText). Caps at maxLength (default 20000 chars); saveTo saves the full text to a file. | Salt okunur |
| take_snapshot | Capture DOM snapshot with stable UIDs. A UID stays valid across snapshots until its element is removed or the page navigates. Output caps at maxLines (default 100); scope with selector or dump the full tree with saveTo. | Salt okunur |
| resolve_uid_to_selector | Resolve UID to CSS selector. Fails if the element is gone. | Salt okunur |
| clear_snapshot | Clear snapshot UIDs. Usually not needed. | Eylem |
| click_by_uid | Click element by UID. Set dblClick for double-click. | Eylem |
| hover_by_uid | Hover over element by UID. | Eylem |
| fill_by_uid | Fill text input/textarea by UID. | Eylem |
35 aracın tümünü gösterDaha az araç göster
drag_by_uid_to_uidEylemDrag element to another (HTML5 drag events).
fill_form_by_uidEylemFill multiple form fields at once.
upload_file_by_uidEylemUpload file to file input by UID.
press_keyEylemPress a single key, optionally with modifiers, to submit, dismiss, navigate or trigger a shortcut. Not for entering text: use fill_by_uid instead.
type_textEylemType text key by key into the focused element, optionally followed by a key such as Enter. Use fill_by_uid to set the value of a known input; use this for elements that only react to real typing, such as autocomplete fields and rich text editors.
screenshot_pageSalt okunurCapture viewport screenshot as base64 PNG. Set fullPage for the whole scrollable document.
screenshot_by_uidSalt okunurCapture element screenshot by UID as base64 PNG.
print_pageSalt okunurPrint the current page to a PDF file using print CSS. Returns the saved file path.
list_downloadsSalt okunurList downloads tracked since startup, including status and saved file path.
clear_downloadsClear the tracked downloads buffer.
set_download_behaviorControl how downloads are handled: allow (save to a destination folder), deny (cancel), or reset to default. Avoids the native save-file dialog. Requires a recent Firefox.
accept_dialogEylemAccept browser dialog. Provide promptText for prompts.
dismiss_dialogEylemDismiss browser dialog.
navigate_historyEylemNavigate history back/forward. UIDs become stale.
set_viewport_sizeEylemSet viewport dimensions in pixels. Applies to the selected tab only.
get_firefox_outputSalt okunurRetrieve Firefox output (stdout/stderr including MOZ_LOG, warnings, crashes, stack traces). Returns recent output from the capture file. Use filters to focus on specific content.
get_firefox_infoSalt okunurGet information about the current Firefox instance configuration, including binary path, environment variables, and output file location.
close_firefox_sessionEylemEnds the browser session. If the server connected to your existing Firefox, this releases the connection and leaves Firefox running. If the server started Firefox itself, this closes it. Call this when the browser task is complete and no further browser interaction is expected.
install_extensionEylemInstall a Firefox extension using WebDriver BiDi webExtension.install command. Supports installing from archive (.xpi/.zip), base64-encoded data, or unpacked directory.
uninstall_extensionEylemUninstall a Firefox extension using WebDriver BiDi webExtension.uninstall command. Requires the extension ID returned by install_extension or obtained from list_extensions.
screencast_startEylemStart recording a screencast (video) of the current page viewport, saving the output to a file in the downloads directory. Returns a screencast id to pass to screencast_stop. Multiple recordings can run at once.
screencast_stopEylemStop an in-progress screencast recording started with screencast_start and finalize the video file. Returns the path to the saved file.
evaluate_scriptEylemRun a JS function in the page and return its result. Prefer this for targeted reads (a value, text, computed style, whether an element exists) instead of a full take_snapshot. Use the UID interaction tools for clicking, typing, and filling.
| drag_by_uid_to_uid | Drag element to another (HTML5 drag events). | Eylem |
| fill_form_by_uid | Fill multiple form fields at once. | Eylem |
| upload_file_by_uid | Upload file to file input by UID. | Eylem |
| press_key | Press a single key, optionally with modifiers, to submit, dismiss, navigate or trigger a shortcut. Not for entering text: use fill_by_uid instead. | Eylem |
| type_text | Type text key by key into the focused element, optionally followed by a key such as Enter. Use fill_by_uid to set the value of a known input; use this for elements that only react to real typing, such as autocomplete fields and rich text editors. | Eylem |
| screenshot_page | Capture viewport screenshot as base64 PNG. Set fullPage for the whole scrollable document. | Salt okunur |
| screenshot_by_uid | Capture element screenshot by UID as base64 PNG. | Salt okunur |
| print_page | Print the current page to a PDF file using print CSS. Returns the saved file path. | Salt okunur |
| list_downloads | List downloads tracked since startup, including status and saved file path. | Salt okunur |
| clear_downloads | Clear the tracked downloads buffer. | |
| set_download_behavior | Control how downloads are handled: allow (save to a destination folder), deny (cancel), or reset to default. Avoids the native save-file dialog. Requires a recent Firefox. | |
| accept_dialog | Accept browser dialog. Provide promptText for prompts. | Eylem |
| dismiss_dialog | Dismiss browser dialog. | Eylem |
| navigate_history | Navigate history back/forward. UIDs become stale. | Eylem |
| set_viewport_size | Set viewport dimensions in pixels. Applies to the selected tab only. | Eylem |
| get_firefox_output | Retrieve Firefox output (stdout/stderr including MOZ_LOG, warnings, crashes, stack traces). Returns recent output from the capture file. Use filters to focus on specific content. | Salt okunur |
| get_firefox_info | Get information about the current Firefox instance configuration, including binary path, environment variables, and output file location. | Salt okunur |
| close_firefox_session | Ends the browser session. If the server connected to your existing Firefox, this releases the connection and leaves Firefox running. If the server started Firefox itself, this closes it. Call this when the browser task is complete and no further browser interaction is expected. | Eylem |
| install_extension | Install a Firefox extension using WebDriver BiDi webExtension.install command. Supports installing from archive (.xpi/.zip), base64-encoded data, or unpacked directory. | Eylem |
| uninstall_extension | Uninstall a Firefox extension using WebDriver BiDi webExtension.uninstall command. Requires the extension ID returned by install_extension or obtained from list_extensions. | Eylem |
| screencast_start | Start recording a screencast (video) of the current page viewport, saving the output to a file in the downloads directory. Returns a screencast id to pass to screencast_stop. Multiple recordings can run at once. | Eylem |
| screencast_stop | Stop an in-progress screencast recording started with screencast_start and finalize the video file. Returns the path to the saved file. | Eylem |
| evaluate_script | Run a JS function in the page and return its result. Prefer this for targeted reads (a value, text, computed style, whether an element exists) instead of a full take_snapshot. Use the UID interaction tools for clicking, typing, and filling. | Eylem |
Yapılandırma
FIREFOX_HEADLESSSet to true to run Firefox without a visible window.
START_URLSTART_URLURL to open when the server starts.
| Ad | Açıklama | Sunucu |
|---|---|---|
| FIREFOX_HEADLESS | Set to true to run Firefox without a visible window. | |
| START_URL | — | |
| START_URL | URL to open when the server starts. |
Otomatik kontroller
Çalıştırıldı 16 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirmozilla/firefox-devtools-mcp is public and reachablegithub.com/mozilla/firefox-devtools-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@mozilla/firefox-devtools-mcp names mozilla/firefox-devtools-mcp as sourcenpmjs.com/package/@mozilla/firefox-devtools-mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @mozilla/firefox-devtools-mcpnpmjs.com/package/@mozilla/firefox-devtools-mcp/v/0.10.7#pro ↗Geçti
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-04github.com/mozilla/firefox-devtools-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @mozilla/firefox-devtools-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok150 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok35 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Firefox DevTools MCP
Model Context Protocol server that lets AI agents use Firefox. It has two main use cases:
- Agentic browsing: the agent uses the browser for regular tasks, such as reading pages, filling forms and going through multi-step flows on websites.
- Agent-assisted web development: the agent loads the page you are working on and inspects it with developer tools, such as the console, network requests, the debugger and the profiler.
It controls Firefox through WebDriver BiDi (via Selenium WebDriver) and works with Claude Code, Claude Desktop, Cursor, Cline and other MCP clients.
Repository: https://github.com/mozilla/firefox-devtools-mcp
Note: This MCP server requires a local Firefox browser installation and cannot run on cloud hosting services like glama.ai. Use
npx @mozilla/firefox-devtools-mcp@latestto run locally, or use Docker with the provided Dockerfile.
Security
Browser MCP servers carry inherent risks. A few key practices:
- Use a dedicated Firefox profile. Never run the server against your regular profile — the agent has access to whatever the browser can reach, including cookies and saved sessions.
- Be cautious about which sites you visit. Pages can return content designed to manipulate the agent (prompt injection). Stick to sites you control or trust.
- Enable only the tool modules you need. The default
basicpreset already includesevaluate_script;--tool-preset slimdrops it. Higher presets such as--tool-preset developer(debugging, network, console, profiler) and--tool-preset mozilla(privileged context) expand what the agent can do further.
See SECURITY.md for a full breakdown of risks and how to report vulnerabilities.
Requirements
- Node.js ≥ 20.19.0
- Firefox 100+ installed (auto‑detected, or pass
--firefox-path)
Install and use with Claude Code or Codex (npx)
Recommended: use npx so you run the latest published version from 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 — Edit the configuration file
Claude Code
Add to Claude Code’s mcp_settings.json:
{
"mcpServers": {
"firefox-devtools": {
"command": "npx",
"args": ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"],
"env": {
"START_URL": "about:blank"
}
}
}
}
Codex
Add to ~/.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 — Helper script (local dev build)
npm run setup
# Choose Claude Code; the script saves JSON to the right path
Try it with MCP Inspector
npx @modelcontextprotocol/inspector npx @mozilla/firefox-devtools-mcp@latest --start-url https://example.com --headless
Then call tools like:
list_pages,select_page,navigate_pagetake_snapshotthenclick_by_uid/fill_by_uidlist_network_requests(always‑on capture),get_network_requestlist_downloads(always‑on capture),set_download_behaviorscreenshot_page,list_console_messages
CLI options
You can pass flags or environment variables (names on the right):
--firefox-path— absolute path to Firefox binary--headless— run without UI (FIREFOX_HEADLESS=true)--viewport 1280x720— initial window size--profile-path— use a specific Firefox profile. Firefox runs in afirefox_mcp_profilesubfolder of that path, marked with a.firefox-mcpfile; pointing--profile-pathat a marked profile reuses it directly--firefox-arg— extra Firefox arguments (repeatable)--start-url— open this URL on start (START_URL)--accept-insecure-certs— ignore TLS errors (ACCEPT_INSECURE_CERTS=true)--connect-existing— attach to an already-running Firefox instead of launching a new one (CONNECT_EXISTING=true)--marionette-port— Marionette port for connect-existing mode, default 2828 (MARIONETTE_PORT)--idle-timeout— seconds without tool calls after which a connect-existing session releases Firefox, default 1800. Firefox accepts one client at a time, so other clients can only connect once it is released. The next tool call reconnects and selects the tab that is active in Firefox at that moment (IDLE_TIMEOUT)--pref name=value— set Firefox preference at startup viamoz:firefoxOptions(repeatable)--tool-preset— select which tool modules to enable:slim,basic(default),developer,mozilla, orall. See Tool modules and presets. (TOOL_PRESET)--tools— explicit list of tool modules to enable, overriding--tool-presetentirely (e.g.--tools pages network script). See Tool modules and presets.--enable-script— deprecated, use--tool-preset developeror--tools ... script debugging. Selects thedevelopertool preset. (ENABLE_SCRIPT=true)--enable-privileged-context— deprecated, use--tool-preset mozillaor--tools ... privileged prefs. Selects themozillatool preset. RequiresMOZ_REMOTE_ALLOW_SYSTEM_ACCESS=1(ENABLE_PRIVILEGED_CONTEXT=true)--android-device— enable Firefox for Android mode; value is the ADB device serial (e.g.emulator-5554). Runadb devicesto list connected devices. Omit the value or useautoto select the single connected device automatically.--android-wipe-app-data— confirm that Android mode wipes all data of the target app. Required together with--android-device. (ANDROID_WIPE_APP_DATA=true)--android-package— Android app package name, defaultorg.mozilla.firefox. Other packages:org.mozilla.firefox_betafor Firefox Beta,org.mozilla.fenixfor Firefox Nightly,org.mozilla.fenix.debugfor Firefox Nightly Debug,org.mozilla.geckoview_examplefor geckoview (ANDROID_PACKAGE)--unrestricted-save-paths— let thesaveToparameter write anywhere on disk instead of the default roots. See Saving bulky output to disk and the security note in SECURITY.md. (UNRESTRICTED_SAVE_PATHS=true)--log-file— write MCP server logs to a file instead of stderr. Useful for debugging sessions with MCP clients that hide server output. SetDEBUG=*to also include verbose debug logs. Example:--log-file /tmp/firefox-mcp.log
Tool modules and presets
Tools are grouped into modules. You choose which modules to expose either with a named preset
(--tool-preset) or with an explicit list (--tools). When both are given, --tools wins and
the preset is ignored.
Presets (each is a superset of the previous):
slim— the minimum to browse and interact with pagesbasic(default) — adds tools for regular browsingdeveloper— adds tools for web developersmozilla— adds tools for Firefox developersall— every module
See docs/tools.md for the list of modules and the modules in each preset.
Note that basic, the default, includes script and therefore the evaluate_script tool.
See SECURITY.md for what that means for the attack
surface, and use --tool-preset slim or an explicit --tools list to drop it.
# Use the developer preset (adds network, console, debugging and profiler tools)
npx @mozilla/firefox-devtools-mcp --tool-preset developer
# Enable only the modules you need
npx @mozilla/firefox-devtools-mcp --tools pages network console
The prefs and privileged modules require MOZ_REMOTE_ALLOW_SYSTEM_ACCESS=1 and are only
available in the Mozilla-internal build. The launch module requires the Mozilla-internal
build too: it restarts Firefox under a caller-chosen binary, profile, environment and set of
preferences, which is a configuration change the operator should own. Use --pref,
--firefox-path and the other command-line options instead. The bidi module also requires
the Mozilla-internal build: it sends any WebDriver BiDi command, so it gives access to what the
other modules expose. The public package skips these modules even if requested and logs a
warning naming the modules it dropped.
Useful preferences (--pref)
- remote.prefs.recommended=false. When Firefox runs in automation, it applies RecommendedPreferences that modify browser behavior for testing. Set remote.prefs.recommended to false to skip those and have a configuration closer to a regular Firefox instance.
- remote.log.level=Trace. Enable verbose WebDriver protocol logs in Firefox. The MCP server will automatically pass the matching log level to geckodriver so both sides log at the same verbosity.
- app.update.disabledForTesting=false. Allow Firefox to automatically download and apply updates. Note that updates may interrupt your session. Requires also setting remote.prefs.recommended=false.
Firefox for Android
Use --android-device to automate Firefox running on an Android device. Requires adb on your PATH and geckodriver, which is managed automatically.
Warning: Android mode wipes all data of the target app before every session. Tabs, history, bookmarks, passwords, cookies and settings are all lost. geckodriver runs
adb shell pm clear <package>when creating the session and offers no way to skip it, then runs the session on its own temporary profile which is deleted afterwards. Because of this,--android-devicerequires--android-wipe-app-data, and you should install a build dedicated to automation rather than automating the browser you use. Bug 2064088 tracks adding an option to geckodriver to keep the existing app data.
# List connected devices
adb devices
# Launch Firefox for Android on the single connected device
npx @mozilla/firefox-devtools-mcp --android-device auto --android-wipe-app-data
# Target a specific device
npx @mozilla/firefox-devtools-mcp --android-device <serial> --android-wipe-app-data
# Use Firefox Nightly instead
npx @mozilla/firefox-devtools-mcp --android-device <serial> --android-package org.mozilla.fenix --android-wipe-app-data
Port forwarding between the host and device is handled automatically by geckodriver.
Connect to existing Firefox
Use --connect-existing to automate your real browsing session, with cookies, logins, and open tabs intact:
# Start Firefox with Marionette and the Remote Agent (BiDi)
firefox --marionette --remote-debugging-port
# Run the MCP server
npx @mozilla/firefox-devtools-mcp --connect-existing --marionette-port 2828
Both flags are required because the MCP uses both WebDriver Classic (--marionette) and WebDriver BiDi (--remote-debugging-port). If Firefox is only started with --marionette, the MCP server fails to connect and asks you to restart Firefox with both flags.
If Firefox is already running with the same profile, the command above only opens a new window in that instance: the flags are ignored, so neither Marionette nor the Remote Agent starts.
To keep your everyday Firefox running without Marionette, give the MCP server its own profile. Firefox runs one process per profile, so both instances run side by side, and the agent only reaches what you sign in to in that profile:
# Once: create a dedicated profile
firefox -CreateProfile firefox-mcp
# Start it with Marionette and the Remote Agent, next to your everyday Firefox
firefox -P firefox-mcp --marionette --remote-debugging-port
Warning: Do not leave Marionette enabled during normal browsing. It sets
navigator.webdriver = trueand changes other browser fingerprint signals, which can trigger bot detection on sites protected by Cloudflare, Akamai, etc. Only enable Marionette when you need MCP automation, then restart Firefox normally afterward, or run it in a dedicated profile as shown above.
Tool overview
See docs/tools.md for the full list of tools by module, with descriptions and parameters (generated from the source).
Saving bulky output to disk
Large tool output can consume significant context in CLI clients like Claude Code. Several
tools accept an optional saveTo parameter that writes the result to a file instead of
returning it inline. See docs/tools.md for the list.
saveTo takes one of three forms:
- a file path (relative to the current working directory, or absolute within
~/.firefox-mcp/output; parent directories are created). Paths reaching a Firefox profile, or the files this server reads back, are refused - an existing directory (a timestamped file is generated inside it)
true(a timestamped file is generated under~/.firefox-mcp/output/)
The response returns the path and byte size. The saved file always holds the full, untruncated data: the inline size safeguards (console message caps, network header truncation, snapshot line caps) never apply to it.
The text-producing tools also accept preview, a number of characters of the saved output to
echo back inline as a short excerpt. The list in docs/tools.md shows which tools support it.
screenshot_page({ saveTo: "page.png" })
take_snapshot({ saveTo: true })
list_network_requests({ urlContains: "api", saveTo: "network.json" })
evaluate_script({ function: "() => performance.getEntries()", saveTo: true, preview: 2000 })
By default, save paths are restricted: relative paths resolve against the current working
directory, and absolute paths are only allowed within ~/.firefox-mcp. Paths that
escape these locations are rejected. Start the server with --unrestricted-save-paths to
write to arbitrary locations, including absolute paths outside that directory.
Saved files can then be viewed for instance with Claude Code's Read tool without impacting context size.
Local development
npm install
npm run build
# Run with Inspector against local build
npx @modelcontextprotocol/inspector node dist/index.js --headless --viewport 1280x720
# Or run in dev with hot reload
npm run inspector:dev
See CONTRIBUTING.md for more details on local development, testing, and CI.
Troubleshooting
- Firefox not found: pass
--firefox-path "/Applications/Firefox.app/Contents/MacOS/firefox"(macOS) or the correct path on your OS. - First run is slow: Selenium sets up the BiDi session; subsequent runs are faster.
- Stale UIDs: a UID stays valid until its element is removed or the page navigates; take a fresh snapshot (
take_snapshot) when a UID tool reports one is gone. - Windows 10: Error during discovery for MCP server 'firefox-devtools': MCP error -32000: Connection closed
-
Solution 1 Wrap with
cmd /c(details):"mcpServers": { "firefox-devtools": { "command": "cmd", "args": ["/c", "npx", "-y", "@mozilla/firefox-devtools-mcp@latest"] } } -
Solution 2 Use the absolute path to
npx(adjust extension —.cmd,.bat,.exe, or.ps1— to match your setup):"mcpServers": { "firefox-devtools": { "command": "C:\\nvm4w\\nodejs\\npx.ps1", "args": ["-y", "@mozilla/firefox-devtools-mcp@latest"] } }
-
Versioning
- Pre‑1.0 API: versions start at
0.x. Use@latestwith npx for the newest release.
Contributing
See CONTRIBUTING.md for how to file issues, run tests, and work on the project locally.
Author
Maintained by Mozilla.
License
Licensed under either of MIT or Apache 2.0 at your option.
Firefox DevTools MCP soruları
Firefox DevTools MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add firefox-devtools-mcp -- npx -y @mozilla/firefox-devtools-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Firefox DevTools MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Firefox DevTools MCP hangi araçları sunar?
35 araç sunar; bunlar arasında list_pages, new_page, navigate_page, select_page, close_page yer alır.
Firefox DevTools MCP için yerel bir Firefox kurulumu gerekiyor mu?
Evet. Sunucu yerel bir Firefox tarayıcısı başlatır veya ona bağlanır; bulut barındırma servislerinde çalışamaz.
Firefox DevTools MCP'yi Claude Code ile nasıl kurarım?
@mozilla/firefox-devtools-mcp paketini npx ile kullanarak claude mcp add komutu aracılığıyla bir MCP server olarak ekleyin.
Yeni bir tane başlatmak yerine halihazırda çalışan bir Firefox'a bağlanabilir mi?
Evet, çalışan bir Firefox'a bağlanmak için --connect-existing bayrağını (veya CONNECT_EXISTING=true) kullanın; Marionette portu varsayılan olarak 2828'dir.
Hangi araç presetleri mevcuttur?
Presetler slim, basic (varsayılan), developer, mozilla ve all şeklindedir; her biri bir öncekinin üst kümesidir. Ayrıca --tools ile modülleri açıkça seçebilirsiniz.
Android üzerindeki Firefox'u otomatize edebilir mi?
Evet, --android-device ve --android-wipe-app-data kullanarak yapabilir; ancak her oturumdan önce tüm uygulama verilerini siler ve adb gerektirir.