Finance Tracker MCP-Server

KI-gestützte Analyse persönlicher Finanzen durch Claude AI unter Verwendung des Model Context Protocol (MCP).

Was dieses Tool macht

Dieser MCP-Server verbindet Claude AI mit Finanztransaktionsdaten und ermöglicht natürlichsprachliche Abfragen zu Ihren Finanzen:

• „Zeige mir meine Ausgaben diesen Monat“

• „Finde alle meine Abonnements“

• „Was waren meine 10 größten Ausgaben?“

• „Zeige Ausgabentrends für die letzten 3 Monate“

• „Suche nach allen Starbucks-Transaktionen“

• „Überprüfe mein Budget: Essen $500, Shopping $300“

Related MCP server: My Finance MCP Server

Funktionen

• 6 Finanzanalysetools

  • Monatliche Ausgabenzusammenfassungen

  • Abonnement-Erkennung (wiederkehrende Abbuchungen)

  • Budgetverfolgung & Warnungen

  • Analyse von Ausgabentrends

  • Ranking der größten Ausgaben

  • Transaktionssuche

• Plaid-Integration

  • Verbindung zu über 10.000 Banken (Sandbox-Modus zum Testen)

  • Echtzeit-Transaktionsdaten (bei Verbindung mit echten Konten)

  • Sicherer API-Zugriff

• Datenschutz zuerst

  • Alle Daten bleiben lokal auf Ihrem Rechner

  • Keine externe Datenspeicherung

  • Verschlüsselte API-Verbindungen

Schnellstart

Voraussetzungen

• Python 3.9 oder höher

• Claude Desktop App

• Plaid-Konto (kostenlos unter https://dashboard.plaid.com)

Installation

1. Repository klonen

   git clone https://github.com/yourusername/finance-plaid-mcp.git
   cd finance-plaid-mcp

2. Virtuelle Umgebung erstellen

   python -m venv venv
   
   # Activate it:
   # Windows:
   venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. Abhängigkeiten installieren

   pip install -r requirements.txt

4. Plaid API-Schlüssel einrichten

   Kopieren Sie .env.example nach .env und fügen Sie Ihre Plaid-Schlüssel von https://dashboard.plaid.com hinzu

   PLAID_CLIENT_ID=your_client_id_here
   PLAID_SECRET=your_sandbox_secret_here
   PLAID_ENV=sandbox
   DATA_DIR=./data

5. Beispieldaten generieren (zum Testen)

   python generate_sample_data.py

6. Claude Desktop konfigurieren

   Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "finance-tracker": {
         "command": "python",
         "args": [
           "/FULL/PATH/TO/finance-plaid-mcp/src/server.py"
         ]
       }
     }
   }

Wichtig: Verwenden Sie den vollständigen absoluten Pfad zu Ihrem Projekt!

7. Claude Desktop neu starten

8. Testen!

   Fragen Sie in Claude: „Finde alle meine Abonnements“

📁 Projektstruktur

finance-plaid-mcp/ ├── src/ │ ├── server.py # MCP-Server (Haupteinstiegspunkt) │ ├── plaid_client.py # Plaid API-Integration │ ├── analyzer.py # Logik zur Transaktionsanalyse │ └── config.py # Konfiguration & Umgebungsvariablen ├── data/ │ └── sample_transactions.json # Generierte Testdaten ├── screenshot.png # Demo-Screenshot ├── .env # Ihre API-Schlüssel (NICHT in Git eingecheckt) ├── .env.example # Vorlage für API-Schlüssel ├── .gitignore # Verhindert das Einchecken von Geheimnissen ├── requirements.txt # Python-Abhängigkeiten └── README.md # Diese Datei

🔧 Verfügbare Tools

Claude kann diese Tools aufrufen, wenn Ihre Finanzen analysiert werden:

🏦 Verbindung zu echten Bankkonten

Derzeit im Sandbox-Modus (nur Testdaten)

Um echte Banken zu verbinden:

1. Wechseln Sie in den Entwicklungsmodus im Plaid-Dashboard

2. Aktualisieren Sie .env: PLAID_ENV=development

3. Implementieren Sie die Plaid Link UI (Web-Schnittstelle für den Bank-Login)

Für Portfolio-/Demo-Zwecke wird der Sandbox-Modus empfohlen, um die Offenlegung echter Finanzdaten zu vermeiden.

📊 Beispielausgabe

Abonnements finden: 19 Abonnements gefunden, insgesamt $18.123/Jahr Top-Abonnements:

Comcast Internet: $130,71/Monat ($915 insgesamt) Apple Store: $180,05/Monat ($900 insgesamt) Verizon Phone Bill: $110,75/Monat ($886 insgesamt) Electric Bill: $119,86/Monat ($839 insgesamt) Zara: $151,91/Monat ($760 insgesamt)

Monatliche Zusammenfassung: Monatliche Summe: $1.510 Einnahmen: $5.000 Ausgaben: $3.490 Netto: $1.510 Ausgaben nach Kategorie:

Lebensmittel: $644 Shopping: $900 Versorgungsunternehmen: $886 Essen gehen: $450 Transport: $380

🛠️ Tech-Stack

• Python 3.14

• MCP SDK - Model Context Protocol

• Plaid API - Bankverbindung & Transaktionsdaten

• Pandas - Datenanalyse

• Claude AI - Natürlichsprachliche Schnittstelle

🔐 Sicherheit & Datenschutz

• ✅ API-Schlüssel in .env gespeichert (niemals eingecheckt)

• ✅ Alle Daten werden lokal verarbeitet

• ✅ Keine externe Protokollierung oder Analytik

• ✅ Plaid bietet Verschlüsselung auf Bankniveau

⚠️ Wichtig: Checken Sie niemals Ihre .env-Datei oder API-Schlüssel bei GitHub ein!

🤝 Mitwirken

Beiträge sind willkommen! Fühlen Sie sich frei:

• Fehler zu melden

• Funktionen vorzuschlagen

• Pull Requests einzureichen

📝 Lizenz

MIT-Lizenz

🙏 Danksagungen

• Erstellt mit Anthropic's MCP

• Unterstützt durch Plaid

⭐ Wenn Sie dies hilfreich fanden, geben Sie dem Repo bitte einen Stern!