プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

MCP Firefly Iii

作者:YakupEmreYerliバージョン 1.2.1i★ 4iパソコンで動くリポジトリ ↗
レジストリ名io.github.YakupEmreYerli/mcp-firefly-iii

インストール方法

What it does

Security-first, self-hosted MCP server for Firefly III — 152 operations behind 5 scoped tools.

  • Connects パソコンで動く
  • Account or key Needs FIREFLY_API_TOKEN · 1 setting to fill in (FIREFLY_API_URL)
  • Category サイバーセキュリティ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気22/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア34/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 37 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

MCP Firefly Iii をインストールして。https://mcp.popnx.com/i/yakupemreyerli-mcp-firefly-iii.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月16日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server MCP Firefly Iii を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "firefly-iii": { "command": "npx", "args": [ "-y", "@yakupemreyerli/firefly-mcp" ], "env": { "FIREFLY_API_URL": "your-value", "FIREFLY_API_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FIREFLY_API_TOKEN, FIREFLY_API_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Firefly Iii のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. MCP Firefly Iii に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FIREFLY_API_URL Firefly III インスタンスの URL(ドメインのみ、または /api/v1 を含む完全なベース URL)
      英語の原文を見るYour Firefly III instance URL (a bare domain, or a full base URL including /api/v1)

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "firefly-iii": {
          "command": "npx",
          "args": [
            "-y",
            "@yakupemreyerli/firefly-mcp"
          ],
          "env": {
            "FIREFLY_API_URL": "your-value",
            "FIREFLY_API_TOKEN": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    MCP Firefly Iii を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が MCP Firefly Iii を使っていると言うか、回答に MCP Firefly Iii のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ MCP Firefly Iii につなげません

MCP Firefly Iii はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · MCP Firefly Iii につなげるアプリを使う

  • MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · サイバーセキュリティ の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server MCP Firefly Iii を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user firefly-iii --env FIREFLY_API_URL=your-value --env FIREFLY_API_TOKEN=your-value -- npx -y @yakupemreyerli/firefly-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FIREFLY_API_TOKEN, FIREFLY_API_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Firefly Iii のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. MCP Firefly Iii に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FIREFLY_API_URL Firefly III インスタンスの URL(ドメインのみ、または /api/v1 を含む完全なベース URL)
      英語の原文を見るYour Firefly III instance URL (a bare domain, or a full base URL including /api/v1)

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user firefly-iii --env FIREFLY_API_URL=your-value --env FIREFLY_API_TOKEN=your-value -- npx -y @yakupemreyerli/firefly-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    MCP Firefly Iii が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    MCP Firefly Iii を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が MCP Firefly Iii を使っていると言うか、回答に MCP Firefly Iii のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server MCP Firefly Iii を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "firefly-iii": { "command": "npx", "args": [ "-y", "@yakupemreyerli/firefly-mcp" ], "env": { "FIREFLY_API_URL": "your-value", "FIREFLY_API_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FIREFLY_API_TOKEN, FIREFLY_API_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Firefly Iii のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. MCP Firefly Iii に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FIREFLY_API_URL Firefly III インスタンスの URL(ドメインのみ、または /api/v1 を含む完全なベース URL)
      英語の原文を見るYour Firefly III instance URL (a bare domain, or a full base URL including /api/v1)

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    MCP Firefly Iii の設定で FIREFLY_API_TOKEN, FIREFLY_API_URL が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    MCP Firefly Iii を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が MCP Firefly Iii を使っていると言うか、回答に MCP Firefly Iii のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

MCP Firefly Iii のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FIREFLY_API_URL) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server MCP Firefly Iii を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "firefly-iii": { "type": "stdio", "command": "npx", "args": [ "-y", "@yakupemreyerli/firefly-mcp" ], "env": { "FIREFLY_API_URL": "your-value", "FIREFLY_API_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FIREFLY_API_TOKEN, FIREFLY_API_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Firefly Iii のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. MCP Firefly Iii に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FIREFLY_API_URL Firefly III インスタンスの URL(ドメインのみ、または /api/v1 を含む完全なベース URL)
      英語の原文を見るYour Firefly III instance URL (a bare domain, or a full base URL including /api/v1)

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    MCP Firefly Iii の設定で FIREFLY_API_TOKEN, FIREFLY_API_URL が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    MCP Firefly Iii を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が MCP Firefly Iii を使っていると言うか、回答に MCP Firefly Iii のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?MCP Firefly Iii を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user firefly-iii --env FIREFLY_API_URL=your-value --env FIREFLY_API_TOKEN=your-value -- npx -y @yakupemreyerli/firefly-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/firefly-mcp"
      ],
      "env": {
        "FIREFLY_API_URL": "your-value",
        "FIREFLY_API_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/firefly-mcp"
      ],
      "env": {
        "FIREFLY_API_URL": "your-value",
        "FIREFLY_API_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "firefly-iii": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/firefly-mcp"
      ],
      "env": {
        "FIREFLY_API_URL": "your-value",
        "FIREFLY_API_TOKEN": "your-value"
      }
    }
  }
}

自分で入力する値

  • FIREFLY_API_URL 必須 env
    Firefly III インスタンスの URL(ドメインのみ、または /api/v1 を含む完全なベース URL)
    英語の原文を見るYour Firefly III instance URL (a bare domain, or a full base URL including /api/v1)
  • FIREFLY_API_TOKEN 秘密 必須 env
    Firefly III の個人アクセストークン(オプション → プロフィール → OAuth → 新しい個人アクセストークンの作成)
    英語の原文を見るFirefly III Personal Access Token (Options → Profile → OAuth → Create New Personal Access Token)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
671/週
接続方法
パソコンで動く
最新バージョンi
1.2.1
レジストリ公開日i
2026年11月16日
コードの最終更新i
2026年11月16日
作者
YakupEmreYerli
パッケージ
npm: @yakupemreyerli/firefly-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント YakupEmreYerli で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:3 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/yakupemreyerli-mcp-firefly-iii.svg)](https://mcp.popnx.com/en/servers/yakupemreyerli-mcp-firefly-iii)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

サイバーセキュリティのほかのサーバーとの比較i

  • このカテゴリのほかの1109件のうち88%よりスターが多い
  • このカテゴリのほかの1109件のうち91%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1109件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Firefly Iiiは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:FIREFLY_API_TOKEN

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は3 日前、最新バージョン(1.2.1)がレジストリに届いたのは3 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

GitHits

Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.

作者:githits-com成長中↓ 3807/週★ 13810 日前更新

パソコンでもクラウドでも✓ 提供元 · githits.com

Snyk MCP

Easily find and fix security issues in your applications leveraging Snyk platform capabilities.

作者:snyk広く使われている↓ 76.2万/週★ 617 か月前更新

パソコンで動く✓ 提供元 · snyk.io

TokenSafe

Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.

作者:tokensafe-dev広く使われている↓ 6785/週★ 46今日更新

パソコンでもクラウドでも✓ 提供元 · tokensafe.dev
似たものと比べる
これ
MCP Firefly Iii
GitHitsDependency Management MCP ServerSnyk MCPTokenSafeDraugr
動く場所パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるパソコンにインストールが必要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/35/53/43/35/53/3
ライセンスMITApache-2.0–Apache-2.0MITApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Firefly III MCP Server

A Model Context Protocol server that gives an AI assistant access to your own Firefly III instance — 152 operations behind 5 scoped tools, with reading, writing and deleting kept as three separate, explicitly-authorized surfaces instead of one tool that can do all three.

Türkçe: README.tr.md

  • *"What did I spend the most on last month?"*
  • *"Find uncategorised transactions from August and suggest categories."*
  • *"Show me subscriptions whose amount went up."*

Everyone runs this against their own Firefly instance with their own token — there is no hosted backend or relay in between.

Listed in the official MCP Registry as io.github.YakupEmreYerli/mcp-firefly-iii, on Glama, and in Firefly III's own third-party apps documentation. Every release is built and published by CI from a tagged commit, with npm provenance attesting that the tarball came from this repository.

Demo

https://github.com/user-attachments/assets/d308b2b5-18ef-4275-a4ed-ccdb7f04386f

40-second demo: month-end in Claude Code. It reads October, finds 35 uncategorised payments, proposes a plan, dry-runs every write, and only writes after you approve, then checks Firefly III again: 0 left. All financial data shown is fabricated.

Features

  • 5 meta-tools, not 152. firefly_query, firefly_mutate, firefly_destructive, plus firefly_list_operations and firefly_get_schema for discovery — a typed registry maps every Firefly endpoint onto these instead of flooding the model's tool list.
  • `dry_run` on every write, returning the exact request — resolved record IDs included — without sending it.
  • Bulk writes can't run blind. Filter-driven updates require max_matches and refuse an incomplete scan before the first write; multi-split transaction groups are rejected outright rather than risk folding their amounts together.
  • Read/write/destructive are separately scoped and enforced, not just annotated — over stdio by the Firefly token, over HTTP by OAuth scope or a static token.
  • Embedded OAuth 2.1 authorization server for Claude web, Claude mobile, and ChatGPT — no separate Keycloak or Authentik install.
  • Docker images for linux/amd64/linux/arm64, and a self-checking documentation pipeline that keeps the tool catalogue in sync with the code.
  • It tells you when it is out of date. Once a day it checks whether a newer version exists and, if so, says so once — a line on stderr, a sentence beside the next answer. MCP_UPDATE_CHECK=false turns it off.

Prerequisites

  • A running Firefly III instance and a Personal Access Token (Firefly III → Options → Profile → OAuth → Create New Personal Access Token)
  • Node.js 20.6+, unless you're using Docker

Usage

MethodTransportBest for
npx — stdiostdioClaude Code, Claude Desktop, Cursor — simplest setup
Static tokenHTTPn8n, automation, headless callers
OAuthHTTP + OAuthClaude web, Claude mobile, ChatGPT — can't hold a static token
DockerHTTPSelf-hosted, either auth mode above
1. stdio (Claude Code, Claude Desktop, Cursor)

One click: Claude Desktop — download firefly-mcp- .mcpb from the latest release and open it; Claude Desktop asks for your Firefly III URL and token and keeps the token in the system keychain. Cursor — the button installs the server with your-firefly.example and your-token as placeholders; replace them in Cursor's MCP settings. VS Code — the button asks for the URL and the token when the server first starts.

Let setup do it — it asks for your Firefly III address and token, checks that they actually work, then configures Claude Code and Claude Desktop if it finds them: npx -y @yakupemreyerli/firefly-mcp setup. For any other client it prints the configuration to paste.

By hand, Claude Code:

claude mcp add firefly --env FIREFLY_API_URL=your-firefly.example --env FIREFLY_API_TOKEN=your-token -- npx -y @yakupemreyerli/firefly-mcp

By hand, Claude Desktop / Cursor / other clients — add to the MCP config file:

{

"mcpServers": { "firefly": { "command": "npx", "args": ["-y", "@yakupemreyerli/firefly-mcp"], "env": { "FIREFLY_API_URL": "your-firefly.example", "FIREFLY_API_TOKEN": "your-token" } } } }

2. Remote HTTP with a static token

For n8n, automation, or any caller that can't drive a browser-based OAuth flow. Set MCP_HTTP_TOKEN in .env, then run npx -y -p @yakupemreyerli/firefly-mcp firefly-mcp-http. Every request to /mcp must carry Authorization: Bearer — one token, full access, no per-connection scoping.

3. Remote HTTP with OAuth (Claude web, Claude mobile, ChatGPT)

None of these clients can hold a static token, and none of them can spawn a local process — they connect to a public HTTPS URL and expect OAuth. With MCP_AUTH_PASSWORD set, this server *is* the OAuth 2.1 authorization server: it handles client registration, PKCE and token exchange itself, so there is no Keycloak, no Google sign-in, and no token to copy anywhere.

Step 1 — give the server a public HTTPS address. Cloudflare Tunnel is the easiest route for a home server (no port forwarding, no certificate); Caddy or Traefik work on a VPS. compose.example.yml ships cloudflare and caddy profiles for exactly this. Say the result is https://mcp.example.com.

Step 2 — configure `.env`:

MCP_AUTH_PASSWORD=a-strong-password-of-at-least-12-characters

MCP_RESOURCE_URL=https://mcp.example.com MCP_AUTH_STATE_DIR=/data/firefly-mcp-auth

MCP_RESOURCE_URL is the external origin, character for character, with no path — not the internal http://firefly-mcp:3000, and not the /mcp connection URL. A mismatch fails the token audience check and the client only reports "invalid token". MCP_AUTH_STATE_DIR must sit on a persistent volume (compose.example.yml mounts one) or every restart de-authorizes every client.

Step 3 — start it and verify:

docker compose -f compose.example.yml up -d

curl https://mcp.example.com/health # {"ok":true,"auth":"oauth-builtin"}

If auth says bearer instead, the password never reached the process and the client will report that the server doesn't support OAuth.

Step 4a — Claude (web, Desktop, iOS/Android). Settings → Connectors → Add custom connector, URL https://mcp.example.com/mcp. Leave the authentication choices as detected — Claude probes the server and picks the flow it supports. The connector then works on every Claude surface you're signed into, phone included.

Step 4b — ChatGPT. In the custom connector / MCP screen, enter the same https://mcp.example.com/mcp and choose OAuth as the authentication method.

Step 5 — enter the password. A Firefly login screen opens in the browser; type MCP_AUTH_PASSWORD. That one screen is the whole decision — the connection is granted all three scopes (firefly:read, firefly:write, firefly:destructive), whatever the client itself asked for. There is no second consent screen: whoever holds the password could have ticked every box on it. To hand out a connection that genuinely cannot write, give the server a read-only Firefly Personal Access Token instead.

Full TLS recipes and troubleshooting: docs/oauth.md.

4. Docker

Recommended for either HTTP mode above:

cp .env.example .env    # fill in the values for the mode you need

docker compose -f compose.example.yml up -d

Swap build: . in compose.example.yml for image: ghcr.io/yakupemreyerli/mcp-firefly-iii:latest to use the prebuilt image — pin a version tag, not :latest, for anything you depend on. Single container without Compose: docker run -d --env-file .env -p 3000:3000 ghcr.io/yakupemreyerli/mcp-firefly-iii:latest. It refuses to start without one of the two auth modes above, and /mcp needs TLS in front — compose.example.yml has optional cloudflare and caddy profiles for that. /health is open, for container probes.

Configuration

VariableDefaultPurpose
FIREFLY_API_URL—Required. A bare domain, or a full base URL including /api/v1.
FIREFLY_API_TOKEN—Required. Personal Access Token.
FIREFLY_DISABLE_SSL_VERIFYfalseOnly for a local instance with a self-signed certificate.
MCP_UPDATE_CHECKtrueDaily check for a newer release. The only request this server makes to anywhere but your Firefly instance, and it carries no data.

Every variable, including HTTP and OAuth mode: docs/configuration.md.

Tools

ToolAnswersRisk
firefly_queryRead anything. Its description carries the catalogue, so choosing an operation costs no extra call.read-only
firefly_mutateCreate or change a record.writes
firefly_destructiveDelete a record, or rewrite one field across many records at once.cannot be undone
firefly_list_operationsWhat can I do with this entity?read-only
firefly_get_schemaWhat parameters does this operation take?read-only

The split is enforced, not just advertised — a delete reached through firefly_query is refused, and a connection granted only

冒頭だけを表示しています。続きはリポジトリで読めます