Firefox DevTools MCP

WebDriver BiDi (Selenium WebDriver के माध्यम से) के जरिए Firefox को स्वचालित करने के लिए Model Context Protocol सर्वर। Claude Code, Claude Desktop, Cursor, Cline और अन्य MCP क्लाइंट के साथ काम करता है।

रिपॉजिटरी: https://github.com/mozilla/firefox-devtools-mcp

नोट: इस MCP सर्वर को स्थानीय Firefox ब्राउज़र इंस्टॉलेशन की आवश्यकता होती है और यह glama.ai जैसी क्लाउड होस्टिंग सेवाओं पर नहीं चल सकता। स्थानीय रूप से चलाने के लिए npx @mozilla/firefox-devtools-mcp@latest का उपयोग करें, या दिए गए Dockerfile के साथ Docker का उपयोग करें।

सुरक्षा

ब्राउज़र MCP सर्वर में अंतर्निहित जोखिम होते हैं। कुछ प्रमुख अभ्यास:

• एक समर्पित Firefox प्रोफ़ाइल का उपयोग करें। सर्वर को अपनी नियमित प्रोफ़ाइल के विरुद्ध कभी न चलाएं — एजेंट के पास वह सब कुछ उपलब्ध है जो ब्राउज़र तक पहुंच सकता है, जिसमें कुकीज़ और सहेजे गए सत्र शामिल हैं।
• आप किन साइटों पर जाते हैं, इस बारे में सतर्क रहें। पेज एजेंट को हेरफेर करने के लिए डिज़ाइन की गई सामग्री लौटा सकते हैं (प्रॉम्प्ट इंजेक्शन)। उन साइटों पर रहें जिन्हें आप नियंत्रित करते हैं या जिन पर भरोसा करते हैं।
• केवल उन्हीं टूल मॉड्यूल को सक्षम करें जिनकी आपको आवश्यकता है। डिफ़ॉल्ट 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

# आर्ग्स के माध्यम से हेडलेस + व्यूपोर्ट
claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# या पर्यावरण चर के माध्यम से
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

# आर्ग्स के माध्यम से हेडलेस + व्यूपोर्ट
codex mcp add firefox-devtools -- \
  npx @mozilla/firefox-devtools-mcp@latest -- --headless --viewport 1280x720

# या पर्यावरण चर के माध्यम से
codex mcp add firefox-devtools \
  --env START_URL=https://example.com \
  --env FIREFOX_HEADLESS=true \
  -- npx @mozilla/firefox-devtools-mcp@latest

विकल्प B — कॉन्फ़िगरेशन फ़ाइल संपादित करें

Claude Code

Claude Code की mcp_settings.json में जोड़ें:

{
  "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 — सहायक स्क्रिप्ट (स्थानीय डेव बिल्ड)

npm run setup
# Claude Code चुनें; स्क्रिप्ट JSON को सही पथ पर सहेजती है

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 विकल्प

आप फ्लैग या पर्यावरण चर (दाईं ओर नाम) पास कर सकते हैं:

• --firefox-path — Firefox बाइनरी का पूर्ण पथ
• --headless — UI के बिना चलाएं (FIREFOX_HEADLESS=true)
• --viewport 1280x720 — प्रारंभिक विंडो आकार
• --profile-path — एक विशिष्ट Firefox प्रोफ़ाइल का उपयोग करें
• --firefox-arg — अतिरिक्त Firefox तर्क (दोहराने योग्य)
• --start-url — प्रारंभ पर यह URL खोलें (START_URL)
• --accept-insecure-certs — TLS त्रुटियों को अनदेखा करें (ACCEPT_INSECURE_CERTS=true)
• --connect-existing — नया लॉन्च करने के बजाय पहले से चल रहे Firefox से जुड़ें (CONNECT_EXISTING=true)
• --marionette-port — connect-existing मोड के लिए Marionette पोर्ट, डिफ़ॉल्ट 2828 (MARIONETTE_PORT)
• --pref name=value — moz:firefoxOptions के माध्यम से स्टार्टअप पर Firefox प्राथमिकता सेट करें (दोहराने योग्य)
• --tool-preset — चुनें कि कौन से टूल मॉड्यूल सक्षम करने हैं: slim, basic (डिफ़ॉल्ट), developer, mozilla, या all। टूल मॉड्यूल और प्रीसेट देखें। (TOOL_PRESET)
• --tools — सक्षम करने के लिए टूल मॉड्यूल की स्पष्ट सूची, --tool-preset को पूरी तरह से ओवरराइड करता है (जैसे --tools pages network script)। टूल मॉड्यूल और प्रीसेट देखें।
• --enable-script — अप्रचलित, --tool-preset developer या --tools ... script debugging का उपयोग करें। developer टूल प्रीसेट का चयन करता है। (ENABLE_SCRIPT=true)
• --enable-privileged-context — अप्रचलित, --tool-preset mozilla या --tools ... privileged prefs का उपयोग करें। mozilla टूल प्रीसेट का चयन करता है। MOZ_REMOTE_ALLOW_SYSTEM_ACCESS=1 की आवश्यकता है (ENABLE_PRIVILEGED_CONTEXT=true)
• --android-device — Android के लिए Firefox मोड सक्षम करें; मान ADB डिवाइस सीरियल है (जैसे emulator-5554)। कनेक्टेड डिवाइस सूचीबद्ध करने के लिए adb devices चलाएं। एकल कनेक्टेड डिवाइस को स्वचालित रूप से चुनने के लिए मान छोड़ दें या auto का उपयोग करें।
• --android-wipe-app-data — पुष्टि करें कि Android मोड लक्षित ऐप का सारा डेटा मिटा देता है। --android-device के साथ आवश्यक। (ANDROID_WIPE_APP_DATA=true)
• --android-package — Android ऐप पैकेज नाम, डिफ़ॉल्ट org.mozilla.firefox। अन्य पैकेज: Firefox Beta के लिए org.mozilla.firefox_beta, Firefox Nightly के लिए org.mozilla.fenix, Firefox Nightly Debug के लिए org.mozilla.fenix.debug, geckoview के लिए org.mozilla.geckoview_example (ANDROID_PACKAGE)
• --unrestricted-save-paths — saveTo पैरामीटर को डिफ़ॉल्ट रूट के बजाय डिस्क पर कहीं भी लिखने दें। बड़े आउटपुट को डिस्क पर सहेजना और SECURITY.md में सुरक्षा नोट देखें। (UNRESTRICTED_SAVE_PATHS=true)
• --log-file — stderr के बजाय फ़ाइल में MCP सर्वर लॉग लिखें। सर्वर आउटपुट छिपाने वाले MCP क्लाइंट के साथ सत्रों को डीबग करने के लिए उपयोगी। वर्बोज़ डीबग लॉग भी शामिल करने के लिए DEBUG=* सेट करें। उदाहरण: --log-file /tmp/firefox-mcp.log

टूल मॉड्यूल और प्रीसेट