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.