MARM-Systems MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

18 herramientas que cubren sesiones, cuadernos, recuperación de memoria y puentes de contexto
Búsqueda semántica mediante incrustaciones vectoriales; clasifica automáticamente el contenido (código/proyecto/libro/general)
Memoria entre clientes: Claude, Qwen, Gemini y cualquier cliente MCP comparten el mismo almacén
Tres transportes: STDIO, HTTP (localhost:8001), WebSocket beta
Almacenamiento local SQLite — nada sale de tu máquina por defecto

Demo en vivo

Cómo se ve en la práctica

marm-systems.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "marm-systems",
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "marm-systems": {
      "command": {
        "path": "uvx",
        "args": [
          "MARM-Systems"
        ]
      }
    }
  }
}

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

claude mcp add marm-systems -- uvx MARM-Systems

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

Casos de uso

Usos del mundo real: MARM-Systems

Construir memoria persistente entre sesiones en un proyecto a largo plazo

👤 Cualquiera que trabaje en un esfuerzo de varias semanas con una IA ⏱ ~15 min beginner

Cuándo usarlo: Sigues re-explicando el mismo contexto del proyecto en cada sesión.

Requisitos previos

MARM-Systems instalado y ejecutándose — docker pull lyellr88/marm-mcp-server && docker run -d -p 8001:8001 lyellr88/marm-mcp-server

Flujo

Inicia una sesión etiquetada con el proyecto

marm_start con etiqueta de proyecto 'dataplatform-migration'. Registra que estamos migrando de Redshift a Snowflake, plazo final de fin de Q2.✓ Copiado

→ Sesión iniciada; entrada inicial guardada
Suelta contexto mientras trabajas

marm_contextual_log: 'Decidimos usar Fivetran para replicación CDC, evaluamos Airbyte pero la sobrecarga de configuración es demasiado alta.'✓ Copiado

→ Clasificado y almacenado automáticamente
En la siguiente sesión, recupera

marm_smart_recall 'qué decidimos sobre la herramienta CDC?'✓ Copiado

→ Emergen decisiones pasadas relevantes

Resultado: La sesión N+1 comienza con todo el contexto de las sesiones 1-N accesible por consulta, sin necesidad de re-escribir.

Errores comunes

Verter cada chat en memoria obstruye la recuperación — Usa marm_contextual_log para decisiones e hitos, no para cada intercambio
La búsqueda vectorial falla con jerga — Etiqueta explícitamente las entradas con nombres de proyecto para fallback por palabra clave

Combinar con: drift

Compartir memoria entre un equipo usando múltiples asistentes de IA

👤 Equipos donde diferentes miembros usan Claude / Qwen / Gemini ⏱ ~45 min advanced

Cuándo usarlo: El conocimiento atrapado en la IA de una persona no debería estarlo.

Flujo

Ejecuta MARM como servidor HTTP compartido

Despliega MARM-Systems en un servidor del equipo; cada compañero apunta su cliente MCP a http://marm.team.internal:8001/mcp.✓ Copiado

→ Todos los clientes se conectan
Registra contexto compartido

marm_contextual_log: 'El manual de recuperación de base de datos está en /runbooks/db-backup.md; última actualización 2026-04-10.'✓ Copiado

→ Todos pueden recuperarlo
Recupera desde cualquier cliente

Desde la sesión Qwen de un compañero: marm_smart_recall '¿cómo restauro la BD?'✓ Copiado

→ Surge la misma respuesta

Resultado: Memoria institucional compartida entre IA.

Errores comunes

La memoria compartida necesita OAuth real — No confíes en las credenciales hardcodeadas de desarrollo — conecta a tu IdP antes de uso en producción
Los datos sensibles se filtran en la recuperación compartida — Usa etiquetas de proyecto y limita las consultas por etiqueta

Usa cuadernos como espacios de trabajo consultables por IA

👤 Estudiantes, investigadores ⏱ ~5 min beginner

Cuándo usarlo: Quieres un área de notas con alcance temático que la IA pueda buscar después.

Flujo

Crea un cuaderno

marm_notebook_add nombre='rust-ownership' con entrada: 'Move vs borrow: move transfiere la propiedad, borrow te permite inspeccionar.'✓ Copiado

→ Cuaderno creado
Añade mientras aprendes

marm_notebook_add 'rust-ownership': 'Borrow mutable es exclusivo; solo uno a la vez.'✓ Copiado

→ Entrada añadida
Recupera después

marm_notebook_show 'rust-ownership'✓ Copiado

→ Cuaderno completo

Resultado: Un diario de aprendizaje consultable.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

marm-systems + drift

drift recuerda convenciones de código; MARM recuerda decisiones de proyecto

Recupera convenciones drift Y decisiones MARM para el proyecto 'dataplatform-migration' y resume dónde interactúan.✓ Copiado

marm-systems + claude-code-organizer

Mueve memorias de corta duración fuera de CC a MARM para recuperación a largo plazo

El Organizador listó mis 12 mayores memorias — mueve las 5 específicas del proyecto a cuadernos MARM.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
marm_start	project?, tags?	Inicio de cualquier sesión de trabajo	gratuito (local)
marm_refresh	session_id?	Recarga contexto en medio de una sesión	gratuito
marm_smart_recall	query: str, top_k?: int	Búsqueda semántica de entradas pasadas	gratuito (incrustaciones locales)
marm_contextual_log	text: str, tags?: str[]	Persiste una decisión/hito/hecho	gratuito
marm_log_session	session_id	Revisa una sesión pasada	gratuito
marm_notebook_add	name: str, entry: str	Notas con alcance temático	gratuito
marm_notebook_use	name: str	Fija un tema para la sesión	gratuito
marm_notebook_show	name: str	Lee un cuaderno	gratuito
marm_summary	scope: session\|notebook\|tag, id	Condensa historial largo	gratuito (local)
marm_context_bridge	from_session, to_session	Razonamiento entre proyectos	gratuito

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — solo local
Tokens por llamada: Las respuestas de recuperación típicamente usan 500-2000 tokens
Monetario: Gratuito, código abierto
Consejo: Rota o archiva sesiones antiguas periódicamente — SQLite maneja la escala pero la calidad de recuperación se degrada con ruido.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: SQLite local; para modo HTTP compartido usa secretos OAuth basados en variables de entorno

Salida de datos: Ninguna por defecto (almacenamiento local); si ejecutas compartido, solo dentro de tu red

No conceder nunca: Exponer el puerto 8001 a la internet pública sin una capa de autenticación

El modo desarrollo envía credenciales OAuth hardcodeadas — cámbialas antes de cualquier despliegue compartido.
La memoria puede acumular datos sensibles; respalda y cifra el archivo SQLite.

Resolución de problemas

Errores comunes y soluciones

No se puede conectar a localhost:8001

Contenedor no ejecutándose. docker ps para verificar; docker start marm-mcp-server.

Verificar: curl http://localhost:8001/docs

La descarga del modelo de incrustaciones falla

La primera ejecución descarga el modelo; necesita red saliente. Después, funciona sin conexión.

Verificar: Revisa los registros de docker para descarga de HuggingFace

La recuperación devuelve entradas no relacionadas

Muy pocas entradas para buenas incrustaciones; añade más, o pre-filtra por etiqueta.

Verificar: marm_smart_recall con filtro de etiqueta

Alternativas

MARM-Systems vs otros

Alternativa	Cuándo usarla	Contrapartida
drift	Quieres memoria específica del código (convenciones, decisiones)	Enfocado en código; menos general
Letta (MemGPT)	Quieres un agente de memoria de nivel investigación, no solo un servidor	Más pesado de ejecutar; arquitectura opinada
Memorias nativas de CC	Solo Claude Code; sin necesidad de múltiples clientes	Sin búsqueda semántica; hincha el contexto

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills