Expense Tracker MCP Server

Ein mit FastMCP (v3.x) und Python entwickelter Model Context Protocol (MCP)-Server, der MCP-kompatiblen Clients wie Claude Desktop und dem MCP Inspector Tools und Ressourcen zur Ausgabenverfolgung bereitstellt.

📋 Voraussetzungen

• Python: 3.10+ (mit Python 3.14 getestet)

• uv: Schneller Python-Paketinstallierer und -Resolver (astral.sh/uv)

• Node.js: v22.x oder v24.x (LTS) — Erforderlich für die Benutzeroberfläche des MCP Inspector

• Claude Desktop (optional): Zum Testen von Tools direkt in Claude

Related MCP server: Demo MCP Server

🚀 Einrichtung & Installation

1. Projekt und Umgebung initialisieren

# Initialize uv project (if starting fresh)
uv init .

# Install FastMCP
uv add fastmcp

2. Node.js für die MCP Inspector-Benutzeroberfläche vorbereiten

Der MCP Inspector (@modelcontextprotocol/inspector) erfordert Node.js v22.19.0+ oder v24+. Wenn Sie nvm-windows verwenden:

nvm install lts
nvm use 24

Installieren Sie den Inspector global oder lassen Sie npx ihn abrufen:

npm install -g @modelcontextprotocol/inspector

🛠️ Ausführung & Entwicklung

Option A: Interaktive Weboberfläche (MCP Inspector)

Um die MCP Inspector-Weboberfläche mit Hot Reloading zu starten:

uv run fastmcp dev inspector main.py

• Lassen Sie dieses Terminal-Fenster geöffnet.

• Die Konsole gibt eine lokale URL mit einem Authentifizierungstoken aus:

  MCP Inspector Web is up and running at:
     http://127.0.0.1:6274?MCP_INSPECTOR_API_TOKEN=<token>

• Öffnen Sie diesen Link in Ihrem Browser, um Tools zu testen, Schemas zu inspizieren und Echtzeit-Anfrage-/Antwort-Logs anzusehen.

Option B: Server direkt ausführen (STDIO)

Um den MCP-Server im Standard-I/O-Modus auszuführen:

uv run fastmcp run main.py

(oder uv run python main.py)

🤖 Verbindung zu Claude Desktop herstellen

1. Speicherort der Konfigurationsdatei

Unter Windows wird die Konfiguration von Claude Desktop unter folgendem Pfad gespeichert:

%APPDATA%\Claude\claude_desktop_config.json

(Vollständiger Pfad: C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json)

2. Konfigurationseinstellungen

Fügen Sie die Definition expense-server unter mcpServers hinzu.

Hinweis: Unter Windows übernehmen GUI-Anwendungen wie Claude Desktop die PATH-Variable der Shell häufig nicht. Geben Sie immer den absoluten Pfad zu uv.exe an.

{
  "mcpServers": {
    "expense-server": {
      "command": "C:\\Users\\hp\\AppData\\Local\\Python\\pythoncore-3.14-64\\Scripts\\uv.exe",
      "args": [
        "run",
        "--directory",
        "g:\\Projects\\expense-tracker-mcp-server",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

3. Claude Desktop neu starten

1. Schließen Sie Claude Desktop vollständig (stellen Sie sicher, dass es über das Windows-System-Tray neben der Uhr beendet wird).

2. Öffnen Sie Claude Desktop erneut.

3. Prüfen Sie unter Einstellungen > Entwickler, ob expense-server verbunden ist.

🧰 Verfügbare Tools (aktuell main.py)

🔧 Fehlerbehebung

1. Unknown command "main". Available commands: inspector, apps.

In FastMCP 3.x ist fastmcp dev eine Befehlsgruppe. Verwenden Sie fastmcp dev inspector main.py anstelle von fastmcp dev main.py.

2. node:util does not provide an export named 'styleText'

Node.js ist älter als v20.12. Aktualisieren Sie Node auf v22+ oder v24+ über nvm install lts && nvm use 24.

3. Cannot find native binding (npm optional dependencies bug)

Der npx-Cache ist durch das Wechseln der Node-Versionen beschädigt. Führen Sie Folgendes aus:

npm cache clean --force
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache\_npx" -ErrorAction SilentlyContinue
npm install -g @modelcontextprotocol/inspector