MCP Thread Persistence Demo

Un servidor MCP (Model Context Protocol) mínimo que persiste notas de hilos de chat en SQLite, con un cliente real que lo pone a prueba a través del transporte stdio real (no solo llamando directamente a las funciones subyacentes).

Construido como ejercicio de aprendizaje que refleja un patrón real de trabajo freelance: «arreglar/implementar llamadas a herramientas MCP que persistan el estado del hilo de chat en una base de datos, con semántica de upsert (crear si es nuevo, actualizar si existe, sin filas duplicadas por hilo).»

Contenido

• server.py — servidor MCP que expone tres herramientas:

  • save_note(user_id, thread_id, content) — realiza un upsert en SQLite, con clave (user_id, thread_id). La segunda llamada en el mismo hilo actualiza la fila existente en lugar de crear un duplicado.

  • get_note(user_id, thread_id) — recupera la nota guardada.

  • list_threads(user_id) — lista todos los hilos de un usuario.

• test_client.py — un cliente MCP real que se conecta a server.py a través de stdio, llama a list_tools y luego pone a prueba las tres herramientas en secuencia (incluyendo llamar a save_note dos veces en el mismo hilo para verificar que el upsert no crea una fila duplicada).

Related MCP server: Claw Memory Bridge

Cómo ejecutarlo

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

python test_client.py

Notas

Fijado a mcp<2 deliberadamente: la versión 2.x del SDK de mcp renombró FastMCP como MCPServer y cambió otras APIs. La mayoría de los tutoriales/bases de código en el mundo real siguen apuntando a la API 1.x de FastMCP, así que a eso apunta esto también.