适合谁
- 本地 Firefox 自动化
- 网页调试和开发工作流
- 使用 Claude Code、Claude Desktop、Cursor 或 Cline 的用户
F
58FMRS · C
官方 Mozilla 项目，适合本地 Firefox 自动化与开发调试。能力覆盖面较广，但浏览器会话和特权模块带来明显安全风险，应使用专用配置文件并限制工具模块。
Mozilla 维护的 Model Context Protocol 服务器，通过 Selenium WebDriver 使用 WebDriver BiDi 自动化 Firefox。它支持页面检查与控制、网络和控制台观测、截图、脚本执行、性能分析及录制等能力。服务器需要本地安装 Firefox，不能直接运行在 glama.ai 等云托管服务上。
工具能力
list_pages
列出页面。
select_page
选择要操作的页面。
navigate_page
导航到指定页面。
take_snapshot
获取页面快照，可保存到文件。
click_by_uid
按快照中的 UID 点击元素。
fill_by_uid
按 UID 填写表单元素。
list_network_requests
列出网络请求，支持筛选和保存结果。
get_network_request
按 ID 获取网络请求详情。
list_downloads
列出下载记录。
set_download_behavior
设置下载行为为允许、拒绝或默认。
screenshot_page
截取页面截图，可保存到文件。
screenshot_by_uid
截取指定 UID 元素的截图。
list_console_messages
列出控制台消息。
evaluate_script
在页面中执行脚本。
evaluate_privileged_script
在特权上下文中执行脚本；需要相应系统访问权限。
install_extension
安装浏览器扩展。
uninstall_extension
卸载浏览器扩展。
list_extensions
列出浏览器扩展；需要相应系统访问权限。
get_firefox_info
获取 Firefox 信息。
get_firefox_output
获取 Firefox 输出。
restart_firefox
重启 Firefox。
set_firefox_prefs
设置 Firefox 首选项。
get_firefox_prefs
获取 Firefox 首选项。
profiler_is_active
检查性能分析器是否运行。
profiler_start
启动性能分析器。
profiler_stop
停止性能分析并保存分析文件。
screencast_start
开始录制页面视口视频。
screencast_stop
停止页面视口视频录制；需要 Firefox 154 或更高版本。
安装接入
需要 Node.js ≥ 20.19.0 和 Firefox 100+。推荐使用 npx：运行 npx @mozilla/firefox-devtools-mcp@latest，或将提供的 Claude Code 配置加入配置文件。可通过 --firefox-path 指定 Firefox 路径，并使用 --headless 等选项。
claude_desktop_config.json
{"mcpServers":{"firefox-devtools":{"command":"npx","args":["-y","@mozilla/firefox-devtools-mcp@latest","--headless","--viewport","1280x720"],"env":{"START_URL":"about:blank"}}}}
选型与风险
不适合谁
- 没有本地 Firefox 安装的环境
- 无法接受代理访问浏览器可访问内容的场景
- 需要云端托管运行的场景
- 不适合在日常浏览配置文件上直接运行
所需权限
- 需要访问本地 Firefox 浏览器及其可访问的网站。
- 建议使用专用 Firefox 配置文件；连接现有浏览器时代理可接触 cookies、登录状态和打开的标签页。
- `prefs` 和 `privileged` 模块需要 `MOZ_REMOTE_ALLOW_SYSTEM_ACCESS=1`，且仅在 Mozilla 内部构建中可用。
- Firefox for Android 模式需要 PATH 中存在 adb，并需要连接的 Android 设备。
风险与副作用
- 浏览器代理天然具有较高风险，可能接触 cookies、保存的会话和浏览器可访问的内容。
- 网页内容可能包含用于操纵代理的提示注入；应只访问自己控制或信任的网站。
- developer 预设会启用脚本和调试工具，mozilla 预设还会扩大到特权上下文，代理能力更强。
- 连接现有 Firefox 会使用真实浏览会话；启用 Marionette 进行日常浏览可能暴露 navigator.webdriver 并触发反机器人检测。
常见排障
- Firefox 未被发现时，使用 `--firefox-path` 指定正确的 Firefox 可执行文件路径。
- 首次运行较慢可能是 Selenium 建立 BiDi 会话所致。
- 导航后 UID 可能失效，应重新调用 `take_snapshot`。
- Windows 10 出现连接关闭时，可按 README 使用 `cmd /c` 包装 npx，或指定 npx 的绝对路径。
- 连接现有 Firefox 时必须同时启用 `--marionette` 和 `--remote-debugging-port`。
使用场景
自动化 Firefox 页面导航和交互
检查页面快照、网络请求和控制台消息
执行页面脚本、截图和性能分析
录制页面视口并管理下载
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Cursor完整支持
Cline完整支持