MCP Memory Service — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Recuperación híbrida vectorial + simbólica — menos falsos positivos que almacenes puramente basados en embeddings
Grafo de conocimiento construido automáticamente que vincula entidades, decisiones y proyectos
Consolidación en segundo plano: elimina duplicados, resume y detecta deriva
API REST junto al MCP — mismo almacén, dos clientes
SQLite por defecto (sin infraestructura); conectable a Postgres / pgvector para escala

Demo en vivo

Cómo se ve en la práctica

mcp-memory-service.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-memory-service",
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-memory-service": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-memory-service"
        ]
      }
    }
  }
}

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

claude mcp add mcp-memory-service -- uvx mcp-memory-service

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

Casos de uso

Usos del mundo real: MCP Memory Service

Mantener a Claude sincronizado durante un proyecto de codificación de varias semanas

👤 Desarrolladores en proyectos de larga duración ⏱ ~15 min beginner

Cuándo usarlo: En cada sesión dedicas 10 minutos a recordarle a Claude las convenciones, decisiones y TODOs del proyecto.

Requisitos previos

Servicio de memoria en ejecución — uvx mcp-memory-service (por defecto en ~/.mcp-memory.db)

Flujo

Sembrar el contexto central

Use mcp-memory-service. Store these as project-level memory: 'use bun not npm', 'all DB writes go through src/db/repo.ts', 'no class components in src/ui'.✓ Copiado

→ 3 memorias almacenadas con etiqueta de proyecto
Usar en la siguiente sesión

Recall any project-level rules before suggesting changes to src/ui/Form.tsx.✓ Copiado

→ Reglas relevantes recuperadas; la sugerencia las respeta
Capturar nuevas decisiones

Save: 'switched from React Query to SWR on 2026-04-22 because of Suspense compat'.✓ Copiado

→ Memoria almacenada con fecha; aparecerá la próxima vez que surja el tema

Resultado: Claude trata tu proyecto como un compromiso continuo, no como 100 arranques en frío.

Errores comunes

La memoria crece sin límite; la recuperación empieza a traer cosas antiguas/irrelevantes — Ejecuta consolidate semanalmente; etiqueta las memorias para poder acotar la recuperación a reciente + este-proyecto

Combinar con: filesystem

Dar a un agente asistente personal un perfil persistente de ti

👤 Personas construyendo agentes Claude de uso diario ⏱ ~10 min beginner

Cuándo usarlo: Tu agente diario debería conocer tus preferencias, reuniones recurrentes y personas sin volver a preguntarte.

Flujo

Registrar el perfil

Use mcp-memory-service. Store: my timezone (Asia/Tokyo), my partner's name, my work hours (10–7), recurring 1:1s.✓ Copiado

→ Perfil almacenado con type=profile
Recuperar al vuelo

Schedule 'lunch w/ Alice' for next Tuesday — pick a time that respects my work hours.✓ Copiado

→ Sugerencia usa tu horario de la memoria; no vuelve a preguntar

Resultado: Menos repetición de contexto por tarea.

Errores comunes

Datos sensibles (médicos, financieros) almacenados sin cifrar — Usa una ruta de BD separada (FS cifrado o compilación con SQLCipher); o simplemente no almacenes datos médicos/financieros en esta capa

Combinar con: google-workspace-mcp

Construir un grafo de conocimiento de investigación mientras lees artículos

👤 Investigadores, analistas, lectores en profundidad ⏱ ~60 min intermediate

Cuándo usarlo: Estás leyendo 30 artículos y quieres rastrear entidades, afirmaciones y contradicciones.

Flujo

Ingerir conforme avanzas

For each paper I link, extract: authors, key claims, methods, datasets — store as linked nodes.✓ Copiado

→ Conteo de nodos creciendo; vínculos visibles
Encontrar contradicciones

Across stored papers, find claims that contradict. List with sources.✓ Copiado

→ Pares de afirmaciones contradictorias con citas
Generar un survey

Draft a 2-page survey with the dominant claim threads + contradictions noted.✓ Copiado

→ Survey en Markdown con afirmaciones citadas

Resultado: Una síntesis real, no solo notas.

Errores comunes

La calidad de la extracción varía — algunas afirmaciones son ruido — Poda periódicamente los nodos de baja confianza; el trabajo de consolidación ayuda pero no hace milagros

Combinar con: filesystem

Compartir el registro de decisiones del proyecto entre agentes de compañeros de equipo

👤 Equipos pequeños que usan agentes de desarrollo con IA ⏱ ~30 min advanced

Cuándo usarlo: Tres personas en el equipo usan Claude Code; nadie sabe qué decisiones ya tomaron los agentes de los demás.

Requisitos previos

Instancia alojada accesible por todos — Ejecuta con --host 0.0.0.0 en un servidor compartido de desarrollo; o despliega la imagen Docker

Flujo

Apuntar las configuraciones del equipo al servicio compartido

Update each teammate's MCP config to use the shared URL with separate auth tokens.✓ Copiado

→ Todos los agentes leen/escriben el mismo almacén
Convención: etiquetar decisiones

Convention: anything stored as type=decision is team-visible; type=personal is namespaced.✓ Copiado

→ Etiquetas aplicadas; recuperación acotada en consecuencia

Resultado: Memoria a nivel de equipo sin una wiki.

Errores comunes

Notas personales etiquetadas accidentalmente como visibles para el equipo — Usa type=personal por defecto; requiere opt-in explícito con type=decision para notas del equipo

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mcp-memory-service + filesystem

Anclar la memoria en archivos del repositorio — vincular memory_id ↔ ruta de archivo

When I edit src/db/repo.ts, recall any decisions referencing it before suggesting changes.✓ Copiado

mcp-memory-service + github

Almacenar automáticamente resúmenes de revisión de PR como memoria de decisión

After every merged PR, store the design rationale + reviewer concerns as type=decision tagged with the repo.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
store_memory	content, tags?, type?, metadata?	Ante cualquier hecho / decisión que valga la pena conservar	0
recall	query, top_k?, tags?, since?	Primer paso antes de responder — no reinventes el contexto	0
graph_neighbors	node_id, depth?	Explorar entidades/decisiones relacionadas	0
consolidate	scope?	Mantenimiento semanal; fusiona duplicados	Tokens LLM para resumir
delete_memory	memory_id	Derecho al olvido o corrección de datos erróneos	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — todo local
Tokens por llamada: La recuperación devuelve 200–2000 tokens según top_k
Monetario: Gratuito; la consolidación usa LLM local o BYO
Consejo: Limita top_k=5 para la mayoría de llamadas de recuperación; deja que la consolidación maneje los duplicados en lugar de sobrecargar los prompts

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: filesystem write to db path

Almacenamiento de credenciales: BD en ~/.mcp-memory.db; cifra el FS o usa la compilación con SQLCipher para datos sensibles

Salida de datos: Ninguna por defecto; la consolidación puede hacer llamadas externas si la conectas a un LLM

No conceder nunca: BD con lectura pública en servidores compartidos

Los datos personales (PII) entran a través de las memorias — aplica una política de retención de datos a nivel de aplicación

Resolución de problemas

Errores comunes y soluciones

La recuperación no devuelve nada

Verifica el filtro de etiquetas; el índice de embeddings puede necesitar reconstrucción tras cambios de esquema

Verificar: Look at tool result count and the tags you pass

Errores de BD bloqueada con agentes concurrentes

Cambia al backend Postgres o activa el modo WAL de SQLite (por defecto en versiones recientes)

Verificar: PRAGMA journal_mode;

La consolidación no termina

Acota el alcance: consolidate(scope='last_week') en lugar de la BD completa

Las memorias están llenas de chat irrelevante

Sé más estricto al almacenar — llama a store_memory solo para hechos/decisiones, no para chat casual

Verificar: Audit recent stores; delete cruft

Alternativas

MCP Memory Service vs otros

Alternativa	Cuándo usarla	Contrapartida
claude-mem-skill	Quieres compresión de continuidad entre sesiones, no un almacén de conocimiento a largo plazo	claude-mem es para continuidad por sesión; este es memoria persistente real + grafo
Mem0	Quieres una capa de memoria alojada con SDKs	Cuesta dinero a escala; los datos salen de tu máquina
Letta (formerly MemGPT)	Quieres un runtime de agente completo con memoria integrada, no solo una capa de memoria	Más pesado; opinionado sobre la arquitectura del agente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills