Memorix (MCP server) — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Cross-agent: funciona con Claude Code, Cursor, Codex, Windsurf, Gemini CLI, OpenCode, Antigravity, Trae
Solo-añadir con historial de revisiones
Recuperación por etiquetas (proyecto, lenguaje, decisión)
Backend SQLite local; sincronización en la nube opcional
Mínimo — binario Node único
MIT

Demo en vivo

Cómo se ve en la práctica

memorix-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add memorix-mcp -- npx -y memorix

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Memorix

Compartir convenciones del proyecto entre todos los agentes de código sin reescribirlas

👤 Desarrolladores que usan múltiples herramientas de IA para código ⏱ ~15 min beginner

Cuándo usarlo: Explicas el mismo layout del monorepo a Cursor, Claude Code y Codex el primer día y olvidas cuál sabe qué.

Requisitos previos

Memorix en ejecución — npx memorix — usa por defecto ~/.memorix.db

Flujo

Sembrar memorias

Guarda estos datos sobre mi proyecto: gestor de paquetes pnpm, runtime node 22, bd postgres 16, auth en /apps/api/src/auth (no en /legacy/auth).✓ Copiado

→ 5 memorias añadidas con etiquetas
Recuperar en otro agente

(en Cursor con el mismo Memorix) — ¿Qué convenciones están definidas para este proyecto?✓ Copiado

→ Devuelve las mismas 5 memorias
Actualizar una

Actualiza la memoria: ahora usamos node 24 (antes 22). Conserva el historial.✓ Copiado

→ Actualizado; historial conservado como revisión

Resultado: El contexto del proyecto persiste entre agentes y entre días.

Errores comunes

Las memorias se vuelven obsoletas — Usa decay para marcar memorias antiguas con baja confianza; los agentes las ponderan según corresponde

Capturar decisiones de arquitectura como memorias consultables

👤 Tech leads, ingenieros senior ⏱ ~20 min intermediate

Cuándo usarlo: Tomas una decisión ('no usamos Redux, solo zustand') y quieres que se respete.

Flujo

Registrar la decisión

Guarda decisión: 'Usar zustand, no Redux. Motivo: API más simple, bundle más pequeño.' Etiqueta: state-management.✓ Copiado

→ Decisión guardada con etiqueta
Verificar su aplicación

Siempre que Claude vaya a importar redux en este repo, recházalo y cita la decisión.✓ Copiado

→ Las importaciones posteriores se señalan con la razón guardada

Resultado: Un registro ligero de decisiones que los agentes realmente leen.

Errores comunes

Memorix es por usuario; las decisiones de equipo necesitan sincronización en la nube o un espejo versionado — Usa --export ./adr.json y haz commit; los compañeros hacen --import para sincronizar

Combinar con: github

Transferir una sesión de depuración a otro agente

👤 Desarrolladores que cambian de modelo a mitad de una tarea ⏱ ~10 min intermediate

Cuándo usarlo: Claude ha estado depurando durante 2h y quieres cambiar a Codex sin re-explicar todo.

Flujo

Hacer snapshot

Guarda un snapshot del contexto de depuración actual: hipótesis, qué descartamos, siguiente paso.✓ Copiado

→ Snapshot guardado con etiqueta debug-session-<id>
Retomar en otro agente

(en Codex) — Carga la sesión de depuración y continúa donde Claude lo dejó.✓ Copiado

→ Codex resume el snapshot y propone el siguiente paso

Resultado: Cambio de agente sin dolor a mitad de una tarea.

Errores comunes

El snapshot es demasiado vago; el nuevo agente empieza desde cero — La herramienta snapshot de Memorix solicita: hipótesis, evidencia, siguiente paso — completa los tres

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

memorix-mcp + github

Reflejar memorias en un archivo adr.json versionado para compartir en equipo

memorix-mcp + filesystem

Hacer backup de la base de datos local de Memorix

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
save	content: str, tags: str[]	Persistir un hecho / decisión / snapshot	gratis
recall	query?, tags?, limit?	Traer contexto relevante a la tarea actual	gratis
update	id, content	Corregir o refinar una memoria existente	gratis
decay	older_than_days	Limpieza periódica	gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: SQLite local — limitado por disco
Tokens por llamada: 100–500 por recall
Monetario: Gratis; la sincronización en la nube (si se usa) varía
Consejo: Ejecuta decay semanalmente para que las consultas de recall devuelvan contexto reciente y ajustado, no notas de depuración de hace 6 meses

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: SQLite local por defecto; la sincronización en la nube necesita API key

Salida de datos: Solo local por defecto

Las memorias pueden contener secretos (p. ej. 'usamos la API key XYZ') — revisa antes de exportar / hacer commit

Resolución de problemas

Errores comunes y soluciones

Recall no devuelve nada relevante

Verifica que las etiquetas coinciden — Memorix usa filtros de etiquetas Y texto difuso

Verificar: Ejecuta sin filtro para ver todas las memorias

Error de BD bloqueada

Múltiples agentes escribiendo simultáneamente — Memorix usa WAL; asegúrate de que la versión sea >= 0.4

La importación falla

Esquema no coincidente entre la versión exportadora e importadora — actualiza ambas primero

Alternativas

Memorix vs otros

Alternativa	Cuándo usarla	Contrapartida
doobidoo/mcp-memory-service	Quieres funciones más ricas como grafo de conocimiento y consolidación	Más pesado; Memorix es intencionalmente mínimo
Memoria de OpenAI / Anthropic	Solo usas un proveedor	Vinculado a ese proveedor; Memorix es cross-agent

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills