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. 設定 > 変数 に移動します

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

使用

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

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

この URL を MCP 互換の AI ツールに提供することで、Firefly III インスタンスと連携できます。

カスタムドメイン

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

技術詳細

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

ライセンス

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