Firefox DevTools 用の Model Context Protocol サーバー - AI アシスタントが WebDriver BiDi を通じて Firefox ブラウザを検査および制御できるようにします
AIエージェントがFirefoxを使用できるようにするModel Context Protocolサーバーです。主なユースケースは2つあります:
WebDriver BiDi(Selenium WebDriver経由)を通じてFirefoxを制御し、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サーバーには固有のリスクがあります。いくつかの重要な実践事項:
basicプリセットにはすでにevaluate_scriptが含まれています。--tool-preset slimはそれを除外します。--tool-preset developer(デバッグ、ネットワーク、コンソール、プロファイラー)や--tool-preset mozilla(特権コンテキスト)などのより高いプリセットは、エージェントができることをさらに拡張します。リスクの詳細な内訳と脆弱性の報告方法についてはSECURITY.mdを参照してください。
--firefox-pathを渡す)推奨:npmから公開されている最新バージョンを実行するためにnpxを使用してください。
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
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/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フラグまたは環境変数(名前は右側)を渡すことができます:
--firefox-path — Firefox バイナリへの絶対パス--headless — UI なしで実行(FIREFOX_HEADLESS=true)--viewport 1280x720 — 初期ウィンドウサイズ--profile-path — 特定の Firefox プロファイルを使用。Firefox はそのパスの firefox_mcp_profile サブフォルダ内で実行され、.firefox-mcp ファイルでマークされます。マークされたプロファイルを --profile-path に指定すると、それを直接再利用します--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)--idle-timeout — ツール呼び出しがない状態がこの秒数続くと、connect-existing セッションが Firefox を解放します。デフォルトは 1800。Firefox は一度に 1 つのクライアントしか受け付けないため、他のクライアントは解放されてからでないと接続できません。次のツール呼び出しで再接続し、その時点で Firefox 内でアクティブなタブを選択します(IDLE_TIMEOUT)--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 — Firefox for Android モードを有効化。値は 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 — MCP サーバーのログを stderr ではなくファイルに書き込みます。サーバー出力を隠す MCP クライアントでのデバッグセッションに便利です。詳細なデバッグログも含めるには DEBUG=* を設定してください。例: --log-file /tmp/firefox-mcp.logツールはモジュールにグループ化されています。公開するモジュールは、名前付きプリセット
(--tool-preset)または明示的なリスト(--tools)のいずれかで選択します。両方が指定された場合、
--tools が優先され、プリセットは無視されます。
プリセット(それぞれが前のもののスーパーセット):
slim — ページを閲覧して操作するための最小限の機能basic(デフォルト) — 通常のブラウジング向けのツールを追加developer — Web 開発者向けのツールを追加mozilla — Firefox 開発者向けのツールを追加all — すべてのモジュールモジュールの一覧と各プリセットに含まれるモジュールについては、docs/tools.md を参照してください。
デフォルトである basic には script が含まれ、したがって evaluate_script ツールも含まれることに注意してください。これが攻撃対象領域にとって何を意味するかについては SECURITY.md を参照し、除外するには --tool-preset slim または明示的な --tools リストを使用してください。
# Use the developer preset (adds network, console, debugging and profiler tools)
npx @mozilla/firefox-devtools-mcp --tool-preset developer