Skip to main content
Glama
fire-fodex
by skjshr

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 スクショ

Related MCP server: firefox-bridge

やらないこと

  • 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 で待ち受けます。

Available Tools

24 tools
firefox_backC

Go back in a Firefox tab.

Inputs: sessionTabId (required).

firefox_claim_tabC

Claim an existing Firefox tab by sessionTabId.

Inputs: sessionTabId (required).

firefox_clickC

Click an element in a Firefox tab.

Inputs: sessionTabId (required), selector (required).

firefox_close_tabC

Close a Firefox tab.

Inputs: sessionTabId (required).

firefox_dragC

Drag from one point or element to another.

Inputs: sessionTabId (required), fromX, fromY, fromSelector, +6 more.

firefox_evalB

Run page JavaScript for local browser automation. Obvious cookie/storage extraction is blocked.

Inputs: sessionTabId (required), script (required), frameRef.

firefox_findB

Find visible page elements by text, role, label, placeholder, CSS selector, or approximate query.

Inputs: sessionTabId (required), query (required), by, frameRef, +1 more.

firefox_focusC

Focus an element by selector/ref or viewport point.

Inputs: sessionTabId (required), selector, x, y, +2 more.

firefox_forwardB

Go forward in a Firefox tab.

Inputs: sessionTabId (required).

firefox_keypressC

Send a keyboard key to a Firefox tab.

Inputs: sessionTabId (required), key (required).

firefox_list_tabsA

List current Firefox tabs.

Inputs: no named parameters.

firefox_mouse_clickC

Click by viewport coordinates or selector/ref.

Inputs: sessionTabId (required), x, y, selector, +4 more.

firefox_mouse_moveC

Move the mouse over viewport coordinates or an element.

Inputs: sessionTabId (required), x, y, selector, +2 more.

firefox_navigateC

Navigate a claimed or existing Firefox tab.

Inputs: sessionTabId (required), url (required).

firefox_open_tabC

Open a new Firefox tab.

Inputs: url, active.

firefox_pasteC

Paste text into the focused element or a chosen element.

Inputs: sessionTabId (required), text (required), selector, frameRef, +1 more.

firefox_releaseB

Release a claimed Firefox tab without closing it.

Inputs: sessionTabId (required).

firefox_reloadC

Reload a Firefox tab.

Inputs: sessionTabId (required).

firefox_screenshotC

Capture a PNG screenshot of a Firefox tab.

Inputs: sessionTabId (required), fullPage, cropX, cropY, +2 more.

firefox_scrollC

Scroll the page or a specific element.

Inputs: sessionTabId (required), deltaX, deltaY, selector, +2 more.

firefox_select_textC

Select text in an input, textarea, contenteditable element, or the current document.

Inputs: sessionTabId (required), selector, start, end, +2 more.

firefox_snapshotC

Read a compact DOM snapshot from a Firefox tab.

Inputs: sessionTabId (required), maxTextLength, maxElements.

firefox_typeC

Type text into an element in a Firefox tab.

Inputs: sessionTabId (required), selector (required), text (required), clear.

firefox_wait_forC

Wait for text, selector, navigation, URL substring, load completion, or focus state.

Inputs: sessionTabId (required), kind (required), value, frameRef, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 24 tools

    Disambiguation4/5

    Most tools have distinct purposes, but firefox_click and firefox_mouse_click overlap in functionality, as both can click using selectors. Additionally, firefox_focus and firefox_click could be confused. Overall, the distinctions are clear enough for most use cases.

    Naming Consistency4/5

    All tools consistently use the 'firefox_' prefix. The naming pattern is mostly verb or verb_noun, but there are exceptions like 'mouse_click' (noun+verb) and 'mouse_move', which break the pattern slightly. The majority follow a predictable style.

    Tool Count3/5

    24 tools is on the high side for a browser automation server, but each tool covers a specific action. While the count is above the typical 3-15 range, it is not excessive and reflects the complexity of controlling a browser.

    Completeness4/5

    The tool set covers essential browser automation tasks: navigation, tab management, user input, scrolling, screenshots, and DOM interaction. Missing features like alert handling or file uploads are minor gaps, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A local MCP server for Firefox that gives AI agents full control over the browser via a Unix socket, enabling automation of tabs, pages, cookies, and more without exposing any network ports.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP-capable CLIs to operate real, already-logged-in Firefox tabs via a WebExtension and native messaging, without simulated input. Supports navigation, clicking, typing, reading, screenshots, and console/network capture with policy gating and frame awareness.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that gives local clients controlled access to a Firefox profile, enabling tab listing, reading, interaction, scripting, and screenshots with granular, revocable permissions.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an MCP client to drive a real, already-logged-in Firefox session through a WebExtension rather than a WebDriver connection, so tabs, cookies and logins work as-is without relaunching the browser under remote-control flags. Exposes tools for tab listing and selection, navigation, accessibility-style snapshots, clicking, filling, typing, key presses, file uploads, screenshots and waiting, with per-origin permission grants and opt-in script evaluation.
      MIT