Avie Money Lover MCP / Local Bridge

Inoffizielle Money-Lover-Integration für zwei Arbeitsabläufe:

1. MCP-Server – stellt einem MCP-fähigen Client Lese-/Schreibwerkzeuge für Money Lover bereit.

2. GPT + lokale Brücke – ChatGPT kann Kontoauszugs-JSON vorbereiten/prüfen, während Ihr eigener Rechner das Money-Lover-Token/Cookie aufbewahrt und den endgültigen Import durchführt.

Inoffizielles Projekt. Dieses Repository wird von Money Lover weder unterstützt, gebilligt noch gesponsert. Es verwendet Web-Endpunkte, die in der Money-Lover-Web-App beobachtet wurden. Diese Endpunkte, Authentifizierungsabläufe, Kategorieverhalten und Anti-Bot-Anforderungen können sich ohne Vorankündigung ändern.

Funktionen

• Authentifizierte Benutzerinformationen lesen

• Geldbörsen und Kategorien auflisten

• Transaktionen nach Datumsbereich lesen

• Money-Lover-user_category_v2-Quell-IDs mithilfe des Transaktionsverlaufs in Laufzeit-IDs auflösen

• Einzelne Transaktion ohne Schreiben in der Vorschau anzeigen

• Transaktion mit Duplikatschutz hinzufügen

• Bank-/Kreditkartenabrechnungsstapel in der Vorschau anzeigen

• Ausgaben − Einnahmen mit einem Abrechnungssaldo abgleichen

• Exakte Duplikate, wahrscheinliche Duplikate, unaufgelöste Kategorien und Prüfzeilen kennzeichnen

• Nur nach ausdrücklicher Bestätigung sequenziell importieren

• Erstellte Transaktionen durch erneutes Lesen verifizieren

• Sicheres erneutes Ausführen nach einem Teilimport: exakte Duplikate werden übersprungen

Related MCP server: monarch-mcp

Anforderungen

• Windows 10/11, macOS oder Linux

• Node.js 22+

• Ein Money-Lover-Konto, das Sie kontrollieren

• Für zuverlässiges Schreiben: eine frische Wallet-Besitzer-Sitzung, ggf. aktuelles Browser-Cookie/cf_clearance und den passenden Browser-User-Agent

Schnellstart

git clone https://github.com/haonguyen97ftu/avie-moneylover-mcp.git
cd avie-moneylover-mcp
npm install
npm test

Windows-Hilfsskript-Einrichtung

scripts\setup-windows.cmd

Legen Sie Anmeldedaten nur in der aktuellen Shell fest:

set "MONEYLOVER_ACCESS_TOKEN=YOUR_FRESH_OWNER_TOKEN"
set "MONEYLOVER_CF_CLEARANCE=YOUR_CURRENT_CF_CLEARANCE_VALUE"
set "MONEYLOVER_USER_AGENT=YOUR_EXACT_BROWSER_USER_AGENT"

Dann ausführen:

scripts\doctor.cmd

Empfohlener GPT + lokaler Arbeitsablauf

Bank/card statement
        ↓
ChatGPT extracts + categorizes
        ↓
statement JSON
        ↓
local preview
        ↓
review / duplicate / reconciliation checks
        ↓
explicit IMPORT confirmation
        ↓
Money Lover
        ↓
local verification report

Fügen Sie keine Money-Lover-Tokens, Aktualisierungstokens, Passwörter, Browser-Cookies oder cf_clearance in ChatGPT, GitHub-Issues, Protokolle oder Screenshots ein. ChatGPT benötigt nur den Kontoauszug sowie die generierte Vorschau-/Ergebnis-JSON.

Einen Kontoauszug in der Vorschau anzeigen

scripts\preview.cmd data\your-statement.json

Nach Prüfung importieren

scripts\import.cmd data\your-statement.json

Das Importprogramm verlangt, dass Sie genau Folgendes eingeben:

IMPORT

bevor Schreibvorgänge beginnen.

Die vollständige vietnamesische Anleitung finden Sie unter docs/HUONG_DAN_SU_DUNG.md.

Beobachtetes API-Verhalten

Authentifizierte Anfragen verwenden derzeit:

Authorization: AuthJWT <access_token>

Beobachtete Endpunkte:

Für Schreibvorgänge sind möglicherweise browserähnliche Header und eine aktuelle Cloudflare-Sitzung erforderlich. Unterstützte Umgebungsvariablen umfassen:

• MONEYLOVER_ACCESS_TOKEN

• MONEYLOVER_CF_CLEARANCE

• MONEYLOVER_COOKIE

• MONEYLOVER_USER_AGENT

• MONEYLOVER_TIMEOUT_MS

• MONEYLOVER_CATEGORY_LOOKBACK_DAYS

• MONEYLOVER_WRITE_DELAY_MS

Stapelabrechnungsformat

Beginnen Sie mit data/example-statement.json. Die vollständige Felddokumentation finden Sie unter docs/STATEMENT_FORMAT.md.

Vorschau:

npm run preview -- data\your-statement.json

Import:

npm run import -- data\your-statement.json

Optionale Flags:

• --allow-review – Zeilen einbeziehen, die nach Ihrer Prüfung absichtlich in review belassen wurden

• --allow-mismatch – Schutz vor Abrechnungsabgleich umgehen; nur verwenden, wenn Sie die Abweichung verstehen

• --allow-shared-wallet – Sicherheitsprüfung des Besitzers umgehen; Schreibvorgänge in geteilten Geldbörsen können weiterhin fehlschlagen

• --confirm IMPORT – nicht-interaktive Bestätigung; für den normalen manuellen Gebrauch nicht empfohlen

Sicherheitsstandardeinstellungen

Das Importprogramm verweigert das Schreiben, wenn:

• eine Zeile blocked ist

• eine review-Zeile vorhanden ist, sofern nicht --allow-review angegeben wird

• die Abrechnungsabgleichsdifferenz ungleich Null ist, sofern nicht --allow-mismatch angegeben wird

• der authentifizierte Benutzer nicht der Geldbörsenbesitzer ist, sofern nicht --allow-shared-wallet angegeben wird

• die Bestätigung nicht exakt IMPORT lautet

Beträge müssen positive Zahlen sein.

Kategorie v2

Bei einigen Konten wird eine Quell-/Vorlagenkategorie-ID aus /category/list angezeigt, während /transaction/add eine andere Laufzeitkategorie-ID erwartet. Die Brücke lernt diese Zuordnung aus vorhandenen Transaktionen.

Wenn eine Kategorie noch nie im Verlauf aufgetaucht ist, kopieren Sie:

config/runtime-category-overrides.example.json

nach:

config/runtime-category-overrides.json

und fügen Sie die Laufzeit-ID hinzu, die in einer echten Browser-Transaktionsanfrage beobachtet wurde. Die lokale Überschreibungsdatei wird von Git ignoriert.

Sicherheit bei öffentlichen Repositories

Das Repository ist so konfiguriert, dass standardmäßig keine lokalen Finanzdaten übertragen werden:

• data/*.json wird ignoriert, außer der bereinigten Beispieldatei

• out/ wird ignoriert

• .env* wird ignoriert

• lokale Laufzeitkategorie-Überschreibungen werden ignoriert

• lokale Sitzungshilfsdateien werden ignoriert

Führen Sie vor dem Übertragen Folgendes aus:

npm run repo:check
npm test

Überprüfen Sie dann git status manuell.

Sicherheit

Wenn ein Token, ein Passwort, ein Aktualisierungstoken, ein Browser-Cookie oder ein cf_clearance-Wert offengelegt wurde, behandeln Sie es als kompromittiert und rotieren/widerrufen Sie die Sitzung. Siehe SECURITY.md.

Mitwirken

Fehlerberichte und Pull-Requests sind willkommen. Bitte lesen Sie CONTRIBUTING.md, bevor Sie Änderungen einreichen. Fügen Sie niemals echte Finanzberichte, Kontokennungen, Tokens oder Cookies in Issues oder Test-Fixtures ein.

Dokumentation

• Vietnamesische Anleitung

• Kontoauszugs-JSON-Format

• Architektur

• GitHub-Veröffentlichungsanleitung

• Sicherheitsrichtlinie

• Änderungsprotokoll

• GPT-Auszugsnormalisierungsaufforderung

• GPT-Vorschauprüfungsaufforderung

Lizenz

MIT – siehe LICENSE.