RMANOV/sqlite-memory-mcp

¿Qué hace sqlite-memory-mcp?

Servidor de memoria MCP basado en SQLite con seguridad concurrente WAL, búsqueda FTS5, seguimiento de sesiones, gestión de tareas y sincronización puente entre máquinas.

Características

• Seguridad concurrente WAL: Utiliza Write-Ahead Logging para permitir múltiples lecturas concurrentes y escrituras seguras sin bloqueos.
• Búsqueda FTS5: Búsqueda de texto completo rápida y eficiente sobre los datos almacenados.
• Seguimiento de sesiones: Mantiene un registro de todas las sesiones y sus interacciones.
• Gestión de tareas: Permite crear, asignar, actualizar y realizar un seguimiento del estado de las tareas.
• Sincronización puente entre máquinas: Sincroniza el estado de la memoria entre diferentes máquinas o instancias mediante un mecanismo de puente.

Instalación

git clone https://github.com/RMANOV/sqlite-memory-mcp.git
cd sqlite-memory-mcp
npm install

Configuración

Crea un archivo .env con las siguientes variables de entorno:

MCP_MEMORY_DB_PATH=./memory.db
MCP_MEMORY_BRIDGE_ENABLED=false
MCP_MEMORY_BRIDGE_URL=
MCP_MEMORY_BRIDGE_API_KEY=

Uso

Inicia el servidor:

npm start

Conéctate al servidor MCP desde tu agente (Claude Code, Cursor, Codex, etc.) usando el protocolo MCP. El servidor expone las siguientes herramientas:

• store_memory: Almacena un recuerdo o información.
• search_memory: Busca recuerdos usando FTS5.
• list_sessions: Lista las sesiones activas o recientes.
• create_task: Crea una nueva tarea.
• update_task: Actualiza el estado de una tarea.
• sync_bridge: Fuerza la sincronización con otras instancias.

Ejemplo de uso con Claude Code

{
  "name": "store_memory",
  "arguments": {
    "key": "proyecto_acme_config",
    "value": {
      "nombre": "Proyecto ACME",
      "versión": "2.1.0",
      "última_modificación": "2024-01-15T10:30:00Z"
    },
    "session": "sesion_12345"
  }
}

Sincronización puente

Para habilitar la sincronización entre máquinas, configura las variables de entorno MCP_MEMORY_BRIDGE_ENABLED, MCP_MEMORY_BRIDGE_URL y MCP_MEMORY_BRIDGE_API_KEY. El servidor se comunicará periódicamente con otros servidores emparejados para intercambiar actualizaciones de memoria y tareas.

Licencia

MIT