Finance MCP

Persönliche Finanzverwaltung über das Model Context Protocol (MCP).

Übersicht

Dieser MCP-Server stellt Tools zur Verwaltung persönlicher Finanzen bereit:

• Konten: Bankkonten, Kreditkarten, Ersparnisse

• Transaktionen: Einnahmen, Ausgaben, Überweisungen

• Schulden: Schulden und Zahlungen verfolgen

• Monatliche Zahlungen: Ratenzahlungen (MSI) verfolgen

• Fixe Ausgaben: Wiederkehrende monatliche Ausgaben

• Aktive Darlehen: Geld, das dir andere schulden

• Ersparnisse: Ziele und Bewegungen verfolgen

• Budgets: Monatliche Budgetgrenzen

• Vermögenswerte: Inventar persönlicher Vermögenswerte

Related MCP server: monarchmoney-node

Installation

# Clone the repository
git clone https://github.com/FrancoMeneses/finance-mcp.git
cd finance-mcp

# Install dependencies
pip install -r requirements.txt

# Initialize the database (optional - server creates it on first run)
sqlite3 finance.db < schema/init.sql

Verwendung

Mit Hermes Agent

Füge zu ~/.hermes/config.yaml hinzu:

mcp_servers:
  finance:
    command: "python3"
    args: ["/path/to/finance-mcp/src/finance/server.py"]
    env:
      DB_PATH: "/path/to/finance.db"

Eigenständig

# Set database path
export DB_PATH="/path/to/finance.db"

# Run the server
python src/finance/server.py

Verfügbare Tools

Konten

• list_accounts - Alle Konten auflisten

• get_account - Kontodetails abrufen

• create_new_account - Neues Konto erstellen

• update_account_balance - Kontostand aktualisieren

Kategorien

• list_categories - Alle Kategorien auflisten

• get_category - Kategoriedetails abrufen

Transaktionen

• list_transactions - Transaktionen mit Filtern auflisten

• add_transaction - Neue Transaktion erfassen

Schulden

• list_debts - Schulden auflisten

• get_debt - Schuldendetails abrufen

• add_debt - Neue Schuld registrieren

• record_debt_payment - Schuldenzahlung erfassen

Monatliche Zahlungen (MSI)

• list_monthly_payments - Raten auflisten

• add_monthly_payment - Neue Rate registrieren

Fixe Ausgaben

• list_fixed_expenses - Fixe Ausgaben auflisten

• add_fixed_expense - Fixe Ausgabe hinzufügen

Aktive Darlehen

• list_active_loans - Verliehene Beträge auflisten

• add_active_loan - Neues Darlehen registrieren

• record_loan_payment - Erhaltene Zahlung erfassen

Ersparnisse

• list_savings - Sparziele auflisten

• get_savings_goal - Sparzieldetails abrufen

• add_savings_goal - Sparziel erstellen

• record_savings_movement - Einzahlung/Abhebung vom Sparguthaben erfassen

• list_savings_movements - Sparhistorie anzeigen

Budgets

• list_budgets - Budgets auflisten

Vermögenswerte

• list_assets - Persönliche Vermögenswerte auflisten

• get_assets_total - Gesamtwert der Vermögenswerte abrufen

Zusammenfassungen

• get_account_overview - Kurze Kontozusammenfassung

• get_monthly_report - Monatlicher Einnahmen-/Ausgabenbericht

Datenbankschema

Siehe schema/init.sql für das vollständige Datenbankschema.

Projektstruktur

finance-mcp/
├── README.md
├── requirements.txt
├── schema/
│   └── init.sql         # Database schema
├── src/
│   └── finance/
│       ├── __init__.py
│       ├── server.py    # MCP server (FastMCP)
│       ├── db.py        # Database access layer
│       └── models.py    # Pydantic validation models
├── tests/
│   └── ...
└── docs/
    └── architecture.md

Lizenz

MIT