
firefox-devtools-mcp v0.9.15
Model Context Protocol server for Firefox DevTools - AI सहायकों को Remote Debugging Protocol के माध्यम से Firefox ब्राउज़र का निरीक्षण और नियंत्रण करने में सक्षम बनाता है
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_pagetake_snapshotफिरclick_by_uid/fill_by_uidlist_network_requests(हमेशा-चालू कैप्चर),get_network_requestlist_downloads(हमेशा-चालू कैप्चर),set_download_behaviorscreenshot_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
