Model Context Protocol (MCP) server that lets AI agents browse the web and debug web pages with Firefox
Сервер 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Вы можете передавать флаги или переменные окружения (имена справа):