fire-fodex

Firefox を、MCP agent からそのまま触るためのローカルツールです。

Chrome じゃなくて Firefox を使いたい。

でも AI agent からタブを見たり、クリックしたり、スクショを取ったりしたい。

そのために WebExtension、native messaging、MCP server をつないでいます。

OpenAI の Chrome plugin の移植ではありません。Firefox 用に別で作った橋です。

まだ v1 なので、かなりローカル開発者向けです。拡張機能は手で読み込みます。MCP server も自分で起動します。普段使いのブラウザプロファイルで動かす前に、コードは一回見てください。

できること

• Firefox のタブ一覧を見る
• 新しいタブを開く
• 既存タブを agent 用に確保する
• ページ移動、リロード、戻る、進む
• 表示中ページの軽い snapshot を取る
• 画面内の文字を探す
• クリック、入力、貼り付け、フォーカス、テキスト選択、キー入力
• マウス移動、スクロール、ドラッグ
• 文字や selector が出るまで待つ
• 通常スクショと full-page スクショ

やらないこと

• Firefox の cookie、保存済みパスワード、profile database、localStorage は直接読みません
• ブラウザの情報を勝手に外へ送りません
• cloud sync、account auth、操作録画、権限 UI はありません
• AMO 向けの配布はまだしていません

firefox_eval はあります。ページ側で少しだけ処理したい時の逃げ道です。

ただし sandbox ではありません。cookie、storage、password 抜き取りっぽい文字列は止めますが、それで安全と言い切れるものではないです。信用できない agent に、普段の Firefox profile を触らせないでください。

必要なもの

• Windows
• Firefox Stable
• Node.js 24+
• npm 11+

セットアップ

cd path\to\fire-fodex
npm install
npm run build
npm run install:host

Firefox 側で拡張機能を読み込みます。

1. Firefox を開く
2. about:debugging#/runtime/this-firefox に行く
3. Load Temporary Add-on... を押す
4. extension\manifest.json を選ぶ

MCP server を起動します。

npm run mcp

MCP client 側の設定例です。

{
  "mcpServers": {
    "fire-fodex": {
      "command": "node",
      "args": [
        "path\\to\\fire-fodex\\dist\\mcp-server\\index.js"
      ]
    }
  }
}

Tools

• firefox_list_tabs
• firefox_claim_tab
• firefox_open_tab
• firefox_navigate
• firefox_snapshot
• firefox_screenshot
• firefox_find
• firefox_wait_for
• firefox_mouse_click
• firefox_mouse_move
• firefox_scroll
• firefox_drag
• firefox_focus
• firefox_select_text
• firefox_paste
• firefox_eval
• firefox_click
• firefox_type
• firefox_keypress
• firefox_back
• firefox_forward
• firefox_reload
• firefox_close_tab
• firefox_release

基本は、見てから触る流れです。

• firefox_snapshot や firefox_find で画面を見る
• form は firefox_focus、firefox_paste、firefox_type、firefox_keypress
• pointer 操作は firefox_mouse_click、firefox_mouse_move、firefox_scroll、firefox_drag
• ページが変わる操作の後は firefox_wait_for
• 見た目が大事なら firefox_screenshot

確認

npm run typecheck
npm test
npm run lint:extension
npm run check
powershell -ExecutionPolicy Bypass -File scripts\smoke.ps1

smoke.ps1 は、native host を入れて Firefox 側で拡張機能を読み込んでから動かしてください。

権限

拡張機能は <all_urls> を要求します。普通のサイトを横断して操作するためです。

強い権限です。v1 は「中身を読んで、自分のローカルで動かす」人向けとして置いています。

仕組み

AI agent / MCP client
        |
        | stdio MCP
        v
fire-fodex MCP server
        |
        | localhost JSON request
        v
native messaging host
        |
        | Firefox native messaging stdio
        v
Firefox WebExtension
        |
        | tabs + content scripts
        v
Firefox tabs

拡張機能がつながっている間、native host は 127.0.0.1:17365 で待ち受けます。