خادم Model Context Protocol لأدوات مطوري Firefox - يمكّن مساعدي الذكاء الاصطناعي من فحص متصفح Firefox والتحكم فيه عبر WebDriver BiDi
خادم Model Context Protocol يتيح لوكلاء الذكاء الاصطناعي استخدام Firefox. له حالتان رئيسيتان للاستخدام:
يتحكم في Firefox عبر WebDriver BiDi (من خلال Selenium WebDriver) ويعمل مع Claude Code وClaude Desktop وCursor وCline وغيرها من عملاء MCP.
المستودع: https://github.com/mozilla/firefox-devtools-mcp
ملاحظة: يتطلب خادم MCP هذا تثبيت متصفح Firefox محليًا ولا يمكن تشغيله على خدمات الاستضافة السحابية مثل glama.ai. استخدم
npx @mozilla/firefox-devtools-mcp@latestللتشغيل محليًا، أو استخدم Docker مع ملف Dockerfile المرفق.
تحمل خوادم MCP الخاصة بالمتصفحات مخاطر متأصلة. فيما يلي بعض الممارسات الأساسية:
basic بالفعل evaluate_script؛ بينما يزيلها --tool-preset slim. توسّع الإعدادات المسبقة الأعلى مثل --tool-preset developer (التنقيح والشبكة والطرفية ومحلّل الأداء) و--tool-preset mozilla (سياق مميّز) ما يستطيع الوكيل فعله بشكل أكبر.راجع SECURITY.md للحصول على تفصيل كامل للمخاطر وكيفية الإبلاغ عن الثغرات الأمنية.
--firefox-path)موصى به: استخدم npx لتشغيل أحدث إصدار منشور من npm.
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 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
أضف إلى ملف mcp_settings.json الخاص بـ Claude Code:
{
"mcpServers": {
"firefox-devtools": {
"command": "npx",
"args": ["-y", "@mozilla/firefox-devtools-mcp@latest", "--headless", "--viewport", "1280x720"],
"env": {
"START_URL": "about:blank"
}
}
}
}
أضف إلى ~/.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"
npm run setup
# Choose Claude Code; the script saves JSON to the right path
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يمكنك تمرير أعلام أو متغيرات بيئة (الأسماء على اليمين):