MCP Memory Gateway: Un Servidor MCP para Memoria Persistente en Claude Code

MCP Memory Gateway es un servidor MCP construido específicamente para Claude Code que le otorga memoria persistente entre sesiones. El proyecto aborda el problema donde Claude Code pierde todo el contexto entre sesiones, requiriendo que los usuarios repitan instrucciones como "no hagas push sin revisar los hilos de PR" múltiples veces.

Cómo Funciona

El sistema opera a través de cuatro componentes principales:

• Captura: Los usuarios registran retroalimentación estructurada cuando Claude Code hace algo mal (qué salió mal y qué cambiar) o cuando hace algo bien.
• Promoción: Cuando el mismo fallo aparece 3+ veces, automáticamente se convierte en una regla de prevención.
• Puerta: Las reglas de prevención se convierten en hooks PreToolUse. Antes de que Claude Code ejecute una llamada a herramienta, el motor de puerta verifica si coincide con un patrón de fallo conocido. Si coincide, la llamada se bloquea con una explicación de por qué y qué hacer en su lugar.
• Recordar: Al inicio de sesión, se inyecta contexto relevante de sesiones pasadas para que Claude Code tenga el historial que de otra manera perdería.

Desarrollo con Claude Code

El desarrollador utilizó Claude Code como herramienta principal de desarrollo durante varios meses. Claude Code estuvo involucrado en casi cada parte del proyecto:

• Escribió la lógica inicial del motor de puerta, incluyendo el sistema de coincidencia de patrones que compara llamadas a herramientas contra reglas de fallo almacenadas
• Generó el sistema de validación de retroalimentación que asegura que las entradas estructuradas tengan el esquema correcto antes de almacenarlas
• Construyó la capa de integración del protocolo MCP — manejando registro de herramientas, enrutamiento de solicitudes y formato de respuestas
• Diagnosticó y corrigió un error donde las reglas de prevención no se activaban en llamadas a herramientas anidadas reescribiendo la lógica de coincidencia para manejar cadenas de herramientas recursivas
• Utilizado diariamente para refactorizar, escribir pruebas e iterar en el sistema de recordar que selecciona qué contexto inyectar al inicio de sesión

Comenzando

El núcleo es completamente de código abierto y con licencia MIT sin limitaciones. La configuración se puede realizar con un comando:

npx mcp-memory-gateway init --agent claude-code

El proyecto está disponible en GitHub en https://github.com/IgorGanapolsky/mcp-memory-gateway.