Firefly III MCP Server - Cloudflare Worker

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

查看中文版

Funktionen

• Globale Edge-Bereitstellung basierend auf Cloudflare Workers

• Dienst mit geringer Latenz und hoher Verfügbarkeit

• Keine Serverwartung erforderlich

• Nahtlose Integration mit der Firefly III API

• Tool-Filterung über Voreinstellungen 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 es auf Cloudflare Workers bereit:

   cd packages/cloudflare-worker
   npm run deploy

Konfiguration

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

Erforderliche Variablen

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

• FIREFLY_III_PAT: Ihr persönlicher Zugriffstoken für Firefly III

Optionale Variablen

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

• FIREFLY_III_TOOLS: Kommagetrennte Liste von Tool-Tags, die aktiviert werden sollen (überschreibt FIREFLY_III_PRESET, wenn beide gesetzt sind)

Verfügbare Voreinstellungen

• default: Grundlegende Tools für den täglichen Gebrauch (Konten, Rechnungen, Kategorien, Tags, Transaktionen, Suche, Zusammenfassung)

• full: Alle verfügbaren Tools

• basic: Kern-Tools für die Finanzverwaltung

• budget: Budgetorientierte Tools

• reporting: Berichts- und Analysetools

• admin: Verwaltungstools

• automation: Automatisierungsbezogene Tools

Konfigurationsschritte

1. Gehen Sie zu Ihrem Cloudflare-Dashboard

2. Navigieren Sie zu Workers & Pages

3. Wählen Sie Ihren bereitgestellten Worker aus

4. Gehen 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 auf den MCP-Server über die folgende URL zugreifen:

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

Sie können diese URL MCP-kompatiblen KI-Tools bereitstellen, damit diese mit Ihrer Firefly III-Instanz interagieren können.

Benutzerdefinierte Domäne

Wenn Sie Ihre eigene Domäne verwenden möchten, können Sie in den Cloudflare Workers-Einstellungen eine benutzerdefinierte Domäne konfigurieren. Spezifische 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.