memory-mcp

Servidor MCP de memoria a largo plazo para OpenCode: almacena preferencias, lecciones e historial de uso en un único archivo SQLite local (100% local, sin API externa) para que la IA pueda "recordar y adaptarse" al usuario mediante aprendizaje basado en contexto.

Estado: v1.1.0 — las 4 fases implementadas, pruebas que pasan 70/70 aserciones (smoke 53 + capture 8 + distill 9)

ไทย / Tailandés: README.th.md

Arquitectura

OpenCode ──┬─ Plugin learning-capture (Bun)  ── auto-captures prompts/tool/error into DB
            │                                   └─ injects profile back into context on compaction
            └─ MCP memory-mcp (Node.js stdio)  ── 9 tools read/write the same SQLite DB
                                                      ▲
                               Global instructions (memory-protocol.md) teach the AI to use the tools

Ver design.md para más detalles.

Related MCP server: MCP Vector Memory

Scripts

Herramientas (9)

Instalar con OpenCode

1. Fusiona la sección mcp de opencode.example.json en tu opencode.json (a nivel global o de proyecto)

   • Importante: establece MEMORY_DB_PATH al MISMO archivo de base de datos tanto para el servidor como para el plugin (el ejemplo usa <ABSOLUTE_PATH>/memory-mcp/data/memory.db), de lo contrario el plugin de captura automática escribe en una base de datos diferente a la que la IA lee

   • Cómo configurarlo (elige uno):

     • defínelo en el environment de mcp (ver ejemplo) — cubre solo el servidor MCP

     • o establécelo como variable de entorno a nivel de sistema/usuario (por ejemplo, setx MEMORY_DB_PATH "D:/path/to/memory.db" en Windows) — cubre tanto el servidor como el plugin, ya que el plugin se ejecuta en el mismo proceso que OpenCode

2. Adjunta las reglas de memoria globales — agrega a opencode.json:

   "instructions": ["C:/Users/<user>/.config/opencode/memory-protocol.md"]

   (el contenido de ejemplo de las reglas está en AGENTS.memory.example.md — se puede adjuntar a nivel de proyecto en su lugar)

3. (Opcional) Implementa el plugin de captura automática: copia src/plugin/learning-capture.ts → ~/.config/opencode/plugins/learning-capture.ts

4. Reinicia OpenCode (la configuración se carga solo al inicio)

5. Prueba: "Recuerda que prefiero pnpm" → abre una nueva sesión y pregunta de nuevo

Uso diario

La IA acepta tanto tailandés como inglés indistintamente — puedes cambiar de idioma en cualquier momento sin aviso.

Cuidado a largo plazo: ejecuta npm run distill ocasionalmente para resumir estadísticas y podar interacciones más antiguas de 30 días.

Estructura de data/

data/
├── memory.db          # SQLite (WAL mode) — main DB (+ .db-wal, .db-shm)
└── exports/           # JSON files from export_memory (writeable only in this dir)

• La ruta de la base de datos se puede sobrescribir mediante la variable de entorno MEMORY_DB_PATH

• todo en data/ está ignorado por git