Expense Tracker MCP Server

Ein lokaler Model Context Protocol (MCP)-Server für einen persönlichen Expense Tracker, erstellt mit Python und SQLite3.

Features

• add_expense — fügt eine Ausgabe hinzu; verringert das verfügbare Guthaben

• list_expenses — listet Ausgaben auf (neueste zuerst), optional nach Kategorie gefiltert

• summarize_expenses — Summen nach Kategorie, Anzahl, hinzugefügtes Guthaben und verfügbares Guthaben

• edit_expense — bearbeitet eine Ausgabe; passt das Guthaben um die Differenz des Betrags an

• delete_expense — löscht eine Ausgabe; erstattet den Betrag dem Guthaben

• add_credit — fügt dem verfügbaren Guthaben weiteres Guthaben hinzu

Alle Vorgänge, die das Guthaben verändern, laufen in SQLite-Transaktionen.

Related MCP server: Expense Tracker MCP Server

Ordnerstruktur

local MCP server/
├── main.py                       # MCP server + tool definitions (entry point)
├── expense_tracker/
│   ├── __init__.py
│   ├── database.py               # SQLite connection + schema setup
│   └── operations.py             # Core expense/credit business logic
├── pyproject.toml                # Project config (fastmcp dependency)
├── uv.lock                       # Lockfile
└── README.md

Die Datenbankdatei expense_tracker.db wird automatisch beim ersten Tool-Aufruf erstellt.

Installation

Klonen Sie das Repository:

git clone https://github.com/YogeshSharma2007/Local-Expense-tracker-MCP.git
cd Local-Expense-tracker-MCP

Erstellen und aktivieren Sie eine virtuelle Umgebung:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

Installieren Sie die Abhängigkeiten:

uv sync          # or: pip install -e .

Server ausführen

python main.py

Dann registrieren Sie den Server als lokalen MCP-stdio-Server in Ihrem MCP-Client.

Registrieren mit einem MCP-Client (OpenCode-Beispiel)

Fügen Sie dies zu Ihrer OpenCode-Konfiguration hinzu (opencode.json oder wo auch immer Ihre Client-Konfiguration liegt):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "local-mcp": {
      "type": "local",
      "command": [
        "<path-to-repo>\\.venv\\Scripts\\python.exe",
        "<path-to-repo>\\main.py"
      ],
      "enabled": true
    }
  }
}

Ersetzen Sie <path-to-repo> durch den vollständigen Pfad zu dem Ort, an dem Sie dieses Repository geklont haben, zum Beispiel:

C:\Users\<your-username>\Documents\Local-Expense-tracker-MCP

Konfiguration

Der Datenbankpfad ist standardmäßig expense_tracker.db im Projektordner. Überschreiben Sie ihn mit der Umgebungsvariable:

$env:EXPENSE_TRACKER_DB = "C:\path\to\expense_tracker.db"