Ledger CLI MCP Server

mcp-server-ledger: Ein Ledger CLI MCP-Server

Überblick

Ein Model Context Protocol-Server für die Interaktion mit Ledger CLI , einem leistungsstarken, über die Kommandozeile zugänglichen System der doppelten Buchführung. Dieser Server ermöglicht Large Language Models die Abfrage und Analyse Ihrer Finanzdaten über das Ledger CLI-Tool.

Dieser MCP-Server stellt die Funktionalität von Ledger CLI über eine standardisierte Schnittstelle bereit, sodass KI-Assistenten Sie problemlos bei der Finanzberichterstattung, Budgetanalyse und Buchhaltungsaufgaben unterstützen können.

Merkmale

Der Server bietet die folgenden Tools, die Ledger-CLI-Befehlen entsprechen:

1. ledger_balance
   • Zeigt Kontostände mit leistungsstarken Filteroptionen
   • Eingaben: Abfragemuster, Datumsbereiche, Anzeigeoptionen
   • Rückgabe: Formatierter Saldobericht
2. ledger_register
   • Zeigt das Transaktionsregister mit detaillierter Historie an
   • Eingaben: Abfragemuster, Datumsbereiche, Sortieroptionen
   • Retouren: Formatierter Registerbericht
3. ledger_accounts
   • Listet alle Konten in der Hauptbuchdatei auf
   • Eingabe: optionales Abfragemuster
   • Rückgabe: Liste der übereinstimmenden Konten
4. ledger_payees
   • Listet alle Zahlungsempfänger aus Transaktionen auf
   • Eingabe: optionales Abfragemuster
   • Rückgabe: Liste der übereinstimmenden Zahlungsempfänger
5. ledger_commodities
   • Listet alle verwendeten Rohstoffe (Währungen) auf
   • Eingabe: optionales Abfragemuster
   • Retouren: Liste der passenden Waren
6. ledger_print
   • Druckt Transaktionen im Hauptbuchformat
   • Eingaben: Abfragemuster, Datumsbereiche
   • Rückgabe: Formatierte Hauptbucheinträge
7. ledger_stats
   • Zeigt Statistiken zur Hauptbuchdatei an
   • Eingabe: optionales Abfragemuster
   • Renditen: Statistische Zusammenfassung des Hauptbuchs
8. ledger_budget
   • Zeigt Budgetanalyse
   • Eingaben: Abfragemuster, Datumsbereiche, Berichtszeitraum
   • Retouren: Budgetbericht
9. ledger_raw_command
   • Führt einen einfachen Ledger-CLI-Befehl aus
   • Eingabe: Befehlsargumente als Liste von Zeichenfolgen
   • Rückgabe: Befehlsausgabe als Text

Voraussetzungen

• Ledger CLI muss installiert und in Ihrem PATH verfügbar sein
• Eine gültige Ledger-Datei mit Ihren Finanzdaten

Installation

Verwendung von Docker (empfohlen)

Sie können auch das Docker-Image aus dem Repository minhyeoky/mcp-ledger verwenden:

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

Ersetzen Sie /path/to/your/ledger/file.ledger durch den tatsächlichen Pfad zu Ihrer Ledger-Datei.

Installation über Smithery

So installieren Sie den Ledger CLI MCP Server für Claude Desktop automatisch über Smithery :

Mit UV

Am einfachsten lässt sich dieser Server mit uv installieren und ausführen:

Konfiguration

Der Server benötigt einen Pfad zu Ihrer Ledger-Datei. Dieser kann bereitgestellt werden durch:

• Die Umgebungsvariable LEDGER_FILE
• Kommandozeilenargumente beim Starten des Servers

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

Anwendungsbeispiele

Nach der Konfiguration können Sie Ihrem KI-Assistenten Fragen zu Ihren Finanzdaten stellen:

• „Zeigen Sie mir meine Ausgaben des letzten Monats“
• „Wie hoch ist mein aktueller Kontostand auf allen Konten?“
• „Alle Transaktionen mit Amazon auflisten“
• „Wie viel habe ich im Jahr 2023 für Lebensmittel ausgegeben?“
• „Zeigen Sie mir meine Budgetleistung für Q1“

Die KI verwendet die entsprechenden Ledger-CLI-Befehle über den Server, um die Informationen abzurufen.

Debuggen

Für detailliertere lokale Tests:

Entwicklung

Dieser Server wurde mit dem Model Context Protocol Python SDK erstellt. Weitere Informationen zu MCP und zur Entwicklung von MCP-Servern finden Sie in der offiziellen Dokumentation .

So tragen Sie zu diesem Projekt bei:

1. Klonen Sie das Repository
2. Installieren Sie Entwicklungsabhängigkeiten
3. Nehmen Sie Ihre Änderungen vor
4. Testen Sie mit dem MCP-Inspektor oder durch Integration mit Claude Desktop

Sicherheitsüberlegungen

Dieser Server führt Ledger-CLI-Befehle für Ihre Finanzdaten aus. Er enthält zwar eine grundlegende Validierung, um die Einschleusung von Befehlen zu verhindern, Sie sollten jedoch Folgendes beachten:

• Nur mit vertrauenswürdigen Clients verwenden
• Seien Sie vorsichtig bei der Auswahl der Dateipfade, die Sie offen legen
• Überprüfen Sie alle Befehle vor der Ausführung

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Sie können ihn gemäß den Lizenzbedingungen verwenden, ändern und weitergeben.