ledger-mcp

Ein kleiner MCP-Server, der ein Hauptbuch mit doppelter Buchführung als Werkzeuge für KI-Agenten bereitstellt. Entwickelt als Zwei-Tages-Übung im MCP-Server-Design, in der Ergonomie von Agentenwerkzeugen und in eval-gesteuerter Iteration.

Status: Tag 1 abgeschlossen. Tag 2 (Eval-Harness + Erkenntnisse) läuft.

Was es hier gibt

• ledger.py — Kern des Hauptbuchs mit doppelter Buchführung, basierend auf SQLite. Beträge werden als ganze Cent gespeichert. Erzwingt ausgeglichene Transaktionen und die Integrität benannter Konten.

• server.py — MCP-Server, der vier Werkzeuge bereitstellt: create_account, record_transaction, get_balance, reconcile.

• test_ledger.py — pytest-Suite für den Kern des Hauptbuchs.

• NOTES.md — laufendes Protokoll der Designentscheidungen und Beobachtungen beim Ausführen des Servers mit Claude Desktop.

Related MCP server: Agent Ledger

Lokal ausführen

uv sync
uv run pytest -v          # run the ledger tests
uv run mcp dev server.py  # launch with the MCP Inspector

Um es mit Claude Desktop zu verwenden, füge Folgendes zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ledger": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ledger-mcp", "run", "mcp", "run", "server.py"]
    }
  }
}

Kommender Tag 2

• Eval-Harness, der misst, wo Agenten bei diesen Werkzeugen erfolgreich sind und scheitern

• Dokumentation der Erkenntnisse: Benennung vs. Dokumentation, stilles Anlegen von Konten, Werkzeug als Leitplanke vs. Werkzeug als Ausführender