MCP Thread-Persistenz-Demo

Ein minimaler MCP-Server (Model Context Protocol), der Chat-Thread-Notizen in SQLite persistiert, mit einem echten Client, der ihn über den tatsächlichen stdio-Transport testet (nicht nur durch direkten Aufruf der zugrunde liegenden Funktionen).

Erstellt als Lernübung, die ein echtes Freelance-Job-Muster widerspiegelt: „MCP-Tool-Aufrufe korrigieren/implementieren, die den Chat-Thread-Zustand in einer Datenbank persistieren, mit Upsert-Semantik (neu anlegen, falls nicht vorhanden, aktualisieren, falls vorhanden, keine doppelten Zeilen pro Thread).“

Was hier enthalten ist

• server.py — MCP-Server, der drei Tools bereitstellt:

  • save_note(user_id, thread_id, content) — Upsert in SQLite, basierend auf (user_id, thread_id). Ein zweiter Aufruf für denselben Thread aktualisiert die vorhandene Zeile, anstatt ein Duplikat zu erstellen.

  • get_note(user_id, thread_id) — liest die gespeicherte Notiz zurück.

  • list_threads(user_id) — listet alle Threads für einen Benutzer auf.

• test_client.py — ein echter MCP-Client, der über stdio eine Verbindung zu server.py herstellt, list_tools aufruft und dann alle drei Tools nacheinander ausführt (einschließlich des zweimaligen Aufrufs von save_note für denselben Thread, um zu überprüfen, dass der Upsert keine doppelte Zeile erstellt).

Related MCP server: Claw Memory Bridge

Ausführen

python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python test_client.py

Hinweise

Bewusst auf mcp<2 festgelegt: Die 2.x-Version des mcp-SDK hat FastMCP in MCPServer umbenannt und andere APIs geändert. Die meisten vorhandenen Tutorials/Codebasen da draußen zielen immer noch auf die 1.x-FastMCP-API ab, und genau darauf zielt auch dieses Projekt ab.