akahu-mcp

Ein MCP-Server, der Akahu-Daten (neuseeländisches Open-Banking) für LLM-Agenten wie Claude bereitstellt. Er ermöglicht es dem Agenten, Ihre Bankkonten aufzulisten, Ihre Anlagebestände zu prüfen und Transaktionen zur Analyse abzurufen.

Ein lokaler SQLite-Cache (cache.db) speichert die Transaktionen der letzten ca. 90 Tage auf der Festplatte und aktualisiert sie schrittweise. Die Cache-TTL beträgt 24 Stunden, um der täglichen Upstream-Aktualisierung von Akahu Personal zu entsprechen; Agenten können bei jedem Tool force=True übergeben, um dies zu umgehen.

Tools

• list_accounts(force=False) — Bank-/Einlagenkonten mit Salden. Sharesight ist ausgeschlossen.

• get_share_holdings(force=False) — Sharesight-Portfolio: Gesamtwert, Aufschlüsselung (Renditen / Kapital / Währung / Dividenden) und Zeilen pro Bestand.

• list_transactions(account, start=None, end=None, limit=100, force=False) — Transaktionen für ein Konto aus dem lokalen Cache, wobei zuerst von Akahu aktualisiert wird, wenn der Cache älter als 24 Stunden ist. account wird über die ID oder einen unscharfen Teilstring des Namens abgeglichen.

Einrichtung

1. Installieren Sie uv, falls Sie es noch nicht haben.

2. Richten Sie eine Akahu Personal App ein — dies sind kostenlose Single-User-Apps, die Sie für Ihr eigenes Akahu-Konto erstellen. Sie erhalten ein app_token (die ID der persönlichen App) und ein user_token für sich selbst.

3. Erstellen Sie eine .env-Datei im Projektstammverzeichnis:

   AKAHU_USER_TOKEN=user_token_xxx
   AKAHU_APP_TOKEN=app_token_xxx

4. uv sync, um die Abhängigkeiten zu installieren.

5. Smoke-Test: uv run python -m akahu_mcp.sync — sollte Ihre Konten auflisten und Transaktionen für das erste Konto abrufen.

Einbindung in einen MCP-Host

Claude Code

claude mcp add akahu --scope user -- uv --directory /absolute/path/to/akahu-mcp run akahu-mcp

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder dem entsprechenden Pfad auf Ihrer Plattform hinzu:

{
  "mcpServers": {
    "akahu": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/akahu-mcp", "run", "akahu-mcp"]
    }
  }
}

Wenn Ihr Host uv nicht im PATH finden kann, ersetzen Sie "uv" durch den absoluten Pfad, den Sie mit which uv erhalten.

Hinweise

• Entwickelt und getestet für Akahu Personal Apps, die Upstream-Daten nur einmal täglich aktualisieren — daher die 24-Stunden-Cache-TTL. Die gleichen Endpunkte existieren auch in kommerziellen Plänen, dort könnte es jedoch sinnvoll sein, die TTLs zu verkürzen.

• legacy/ enthält die beiden ursprünglichen Skripte (akahu.py, list_accounts.py), aus denen dieses Projekt hervorgegangen ist. Sie funktionieren weiterhin eigenständig — installieren Sie deren Abhängigkeiten mit uv sync --group legacy, dann uv run --group legacy python legacy/list_accounts.py.