Firefly III MCP Server - Cloudflare Worker

Dieses Paket bietet eine Implementierung des Firefly-III-MCP-Servers (Model Context Protocol) auf Cloudflare Workers. Mit Cloudflare Workers können Sie den MCP-Server einfach in der Cloud bereitstellen und von den Leistungsvorteilen eines globalen Edge-Netzwerks profitieren.

Chinesische Version ansehen

Funktionen

• Globale Edge-Bereitstellung auf Basis von Cloudflare Workers

• Dienst mit niedriger Latenz und hoher Verfügbarkeit

• Keine Serverwartung erforderlich

• Nahtlose Integration mit der Firefly-III-API

• Unterstützung der Tool-Filterung über Presets oder benutzerdefinierte Tags

Related MCP server: Firefly III MCP Server

Bereitstellungsmethoden

Ein-Klick-Bereitstellung

Die einfachste Methode ist die Verwendung der Schaltfläche „Deploy to Cloudflare Workers“ für die Ein-Klick-Bereitstellung:

Manuelle Bereitstellung

1. Klonen Sie dieses Repository:

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

2. Installieren Sie die Abhängigkeiten:

   npm install

3. Erstellen Sie das Projekt:

   npm run build

4. Stellen Sie in Cloudflare Workers bereit:

   cd packages/cloudflare-worker
   npm run deploy

Konfiguration

Nach der Bereitstellung müssen Sie die folgenden Umgebungsvariablen in den Einstellungen Ihrer Cloudflare Workers konfigurieren:

Erforderliche Variablen

• FIREFLY_III_BASE_URL: Die URL Ihrer Firefly-III-Instanz (z. B. https://firefly.yourdomain.com)

• FIREFLY_III_PAT: Ihr persönliches Zugriffstoken (Personal Access Token) für Firefly III

Optionale Variablen

• FIREFLY_III_PRESET: Zu verwendendes Tool-Preset (default, full, basic, budget, reporting, admin, automation)

• FIREFLY_III_TOOLS: Durch Kommas getrennte Liste der zu aktivierenden Tool-Tags (überschreibt FIREFLY_III_PRESET, wenn beide gesetzt sind)

Verfügbare Presets

Konfigurationsschritte

1. Rufen Sie Ihr Cloudflare-Dashboard auf

2. Navigieren Sie zu Workers & Pages

3. Wählen Sie Ihren bereitgestellten Worker aus

4. Wechseln Sie zu Einstellungen > Variablen

5. Fügen Sie die erforderlichen und optionalen Variablen als geheime Variablen hinzu

Verwendung

Nach der Bereitstellung und Konfiguration können Sie unter der folgenden URL auf den MCP-Server zugreifen:

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

Sie können diese URL an MCP-kompatible KI-Tools weitergeben, damit diese mit Ihrer Firefly-III-Instanz interagieren können.

Benutzerdefinierte Domain

Wenn Sie Ihre eigene Domain verwenden möchten, können Sie in den Einstellungen von Cloudflare Workers eine benutzerdefinierte Domain konfigurieren. Konkrete Schritte finden Sie in der Cloudflare-Dokumentation.

Technische Details

Dieses Paket wurde mit dem Hono-Framework erstellt und nutzt die Edge-Computing-Fähigkeiten von Cloudflare Workers.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.