Ausgaben-Tracker MCP-Server

Ein MCP-Server (Model Context Protocol), der es KI-Assistenten wie Claude ermöglicht, persönliche Ausgaben zu verwalten – hinzufügen, kategorisieren, zusammenfassen und budgetieren – unter Verwendung einer lokalen SQLite-Datenbank.

Übersicht

Dieser Server stellt eine Reihe von MCP-Tools bereit, die Claude (oder jeder andere MCP-kompatible Client) aufrufen kann, um Ihre Ausgaben zu verfolgen. Alle Daten werden lokal in einer SQLite-Datei gespeichert – keine Cloud, kein Konto erforderlich.

Funktionen

• Hinzufügen und Verwalten von Ausgaben mit Kategorien, Beträgen, Daten und Beschreibungen

• Filtern und Auflisten von Ausgaben nach Datumsbereich oder Kategorie

• Zusammenfassen der Ausgaben nach Kategorie oder Monat

• Festlegen von Budgets pro Kategorie und Überprüfen der verbleibenden Beträge

• Exportieren von Ausgaben als CSV

• Vollständig lokal – Daten bleiben auf Ihrem Rechner

MCP-Tools

Projektstruktur

expense-tracker-mcp-server/
├── main.py             # MCP server entry point (all tools)
├── expenses.db         # SQLite database (auto-created on first run)
├── pyproject.toml      # Project metadata and dependencies
├── .venv/              # Virtual environment (created by uv)
└── readme.md

Voraussetzungen

• Python 3.11+

• uv (empfohlen) oder pip

• Claude Desktop (um den MCP-Server zu verbinden)

Installation

# Clone the repo
git clone https://github.com/your-username/expense-tracker-mcp-server.git
cd expense-tracker-mcp-server

# Initialize the project and install dependencies
uv init
uv add fastmcp

Dies erstellt automatisch einen .venv-Ordner innerhalb des Projektverzeichnisses.

Ausführen des Servers

fastmcp run main.py

Der Server startet und wartet auf MCP-Verbindungen über stdio. Die SQLite-Datenbank (expenses.db) wird beim ersten Start automatisch erstellt.

Verbindung zu Claude Desktop

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Learning\\Expense-Tracker-MCP-Server",
        "run",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

Beenden Sie Claude Desktop vollständig (System-Tray → Beenden) und öffnen Sie es erneut. Sie sollten die Ausgaben-Tracker-Tools im Tool-Panel sehen.

Beispiel-Prompts

Sobald Sie mit Claude verbunden sind, können Sie sagen:

• "Füge heute eine Ausgabe von 45 $ für Lebensmittel bei Whole Foods hinzu"

• "Zeige mir alle Lebensmittelausgaben aus diesem Monat"

• "Wofür habe ich letzten Monat am meisten ausgegeben?"

• "Setze ein monatliches Budget von 300 $ für Restaurantbesuche"

• "Wie viel von meinem Unterhaltungsbudget ist noch übrig?"

• "Exportiere alle meine Ausgaben vom März als CSV"

Entwicklung

# Run with MCP inspector for debugging
fastmcp dev inspector main.py

Lizenz

MIT