Expense Tracker MCP Server

Ein Model Context Protocol (MCP)-Server, erstellt mit FastMCP (v3.x) und Python, der Tools und Ressourcen für die Ausgabenverfolgung für MCP-kompatible Clients wie Claude Desktop und den MCP Inspector bereitstellt.

📋 Voraussetzungen

• Python: 3.10+ (getestet mit Python 3.14)

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

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

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

Related MCP server: Math Addition 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 UI vorbereiten

nvm install lts
nvm use 24

Installieren Sie den Inspector global oder erlauben Sie npx, ihn abzurufen:

npm install -g @modelcontextprotocol/inspector

🛠️ Ausführung & Entwicklung

Option A: Interaktive Web-UI (MCP Inspector)

Um die MCP Inspector-Web-UI mit Hot Reloading zu starten:

uv run fastmcp dev inspector main.py

• Halten Sie dieses Terminalfenster 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, Schemata zu inspizieren und Echtzeit-Anfrage-/Antwortprotokolle 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 gespeichert unter:

%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 von expense-server unter mcpServers hinzu.

Hinweis: Unter Windows erben GUI-Anwendungen wie Claude Desktop oft nicht den Shell-PATH. Geben Sie immer den absoluten Pfad zu uv.exe an.

{
  "mcpServers": {
    "expense-server": {
      "command": "C:\\Users\\pyash\\AppData\\Local\\Python\\pythoncore-3.14-64\\Scripts\\uv.exe",
      "args": [
        "run",
        "--directory",
        "d:\\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 aus der Windows-Systemleiste in der Nähe der Uhr beendet wird).

2. Öffnen Sie Claude Desktop erneut.

3. Überprüfen Sie Einstellungen > Entwickler, um zu bestätigen, dass expense-server verbunden ist.

🧰 Verfügbare Tools (aktuelles main.py)

🔧 Fehlerbehebung

1. Unknown command "main.py". 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 auf Node v22+ oder v24+ über nvm install lts && nvm use 24.

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

Beschädigter npx-Cache durch Wechsel der Node-Versionen. Führen Sie aus:

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