Firefly III MCP Server - Cloudflare Worker

このパッケージは、Cloudflare Workers 上で Firefly III MCP（Model Context Protocol）サーバーの実装を提供します。Cloudflare Workers を利用すると、MCP サーバーを簡単にクラウドへデプロイでき、グローバルエッジネットワークによるパフォーマンス上の利点を活かせます。

中国語版を見る

特徴

• Cloudflare Workers によるグローバルエッジデプロイ

• 低レイテンシーと高可用性を備えたサービス

• サーバーのメンテナンスが不要

• Firefly III API とのシームレスな連携

• プリセットまたはカスタムタグによるツールフィルタリングのサポート

Related MCP server: Firefly III MCP Server

デプロイ方法

ワンクリックデプロイ

最も簡単な方法は、「Deploy to Cloudflare Workers」ボタンを使用したワンクリックデプロイです。

手動デプロイ

1. このリポジトリをクローンします。

   git clone https://github.com/etnperlong/firefly-iii-mcp.git
   cd firefly-iii-mcp

2. 依存関係をインストールします。

   npm install

3. プロジェクトをビルドします。

   npm run build

4. Cloudflare Workers にデプロイします。

   cd packages/cloudflare-worker
   npm run deploy

設定

デプロイ後、Cloudflare Workers の設定で以下の環境変数を構成する必要があります。

必須変数

• FIREFLY_III_BASE_URL: お使いの Firefly III インスタンスの URL（例: https://firefly.yourdomain.com）

• FIREFLY_III_PAT: お使いの Firefly III パーソナルアクセストークン

オプション変数

• FIREFLY_III_PRESET: 使用するツールプリセット（default、full、basic、budget、reporting、admin、automation）

• FIREFLY_III_TOOLS: 有効にするツールタグのカンマ区切りリスト（両方が設定されている場合は FIREFLY_III_PRESET を上書きします）

利用可能なプリセット

• default: 日常使用向けの基本ツール（accounts、bills、categories、tags、transactions、search、summary）

• full: 利用可能なすべてのツール

• basic: 中核となる財務管理ツール

• budget: 予算に特化したツール

• reporting: レポート作成および分析ツール

• admin: 管理ツール

• automation: 自動化関連ツール

設定手順

1. Cloudflare ダッシュボードに移動します。

2. Workers & Pages に移動します。

3. デプロイした Worker を選択します。

4. Settings > Variables に移動します。

5. 必須変数とオプション変数をシークレット変数として追加します。

使用方法

デプロイと設定が完了すると、以下の URL で MCP サーバーにアクセスできます。

https://your-worker-name.your-account.workers.dev/mcp

この URL を MCP 互換の AI ツールに提供することで、Firefly III インスタンスと対話できるようになります。

カスタムドメイン

独自ドメインを使用する場合は、Cloudflare Workers の設定でカスタムドメインを構成できます。具体的な手順については、Cloudflare のドキュメント を参照してください。

技術詳細

このパッケージは Hono フレームワークを使用して構築されており、Cloudflare Workers のエッジコンピューティング機能を活用しています。

ライセンス

このプロジェクトは MIT ライセンス の下で提供されています。