Memora MCP

Convierte cualquier conversación en una sesión de estudio interactiva, directamente en Claude Desktop. Pídele a Claude que cree una baraja y generará las tarjetas, para luego mostrarlas como un repaso integrado que puedes recorrer: voltea flashcards, responde cuestionarios de opción múltiple y rellena los huecos cloze. Cada respuesta actualiza un calendario de repetición espaciada, y tus resultados vuelven a Claude para que pueda repasar lo que hayas fallado.

Palabras clave: Model Context Protocol, MCP server, MCP Apps, Claude Desktop, flashcards, quizzes, spaced repetition, SRS, FSRS, alternativa a Anki.

Construido sobre la extensión MCP Apps (SEP-1865): especificación MCP principal 2025-11-25 más la extensión Apps 2026-01-26.

Características

Tres formas de estudiar, todas renderizadas integradas y todas evaluadas de la misma manera:

• Flashcards: haz clic para voltear y luego evalúa con Lo sabía / No lo sabía.

• Cuestionarios de opción múltiple: elige una opción y las respuestas correctas/incorrectas se revelan al instante.

• Cloze (rellenar el hueco): el hueco se revela en su sitio para que la frase permanezca intacta. Escribe un hueco como [...] en el anverso de una tarjeta y se convertirá automáticamente en una tarjeta cloze.

Repetición espaciada: cada evaluación actualiza el calendario FSRS de cada tarjeta (mediante ts-fsrs), de modo que las tarjetas débiles reaparecen antes y las tarjetas pendientes salen primero. Pregunta "¿qué hay pendiente hoy?" para obtener un resumen de todas tus barajas.

Organiza con categorías: nombra las barajas con :: para anidarlas (p. ej. LLM::Attention). Navega por el árbol de categorías, o por el mismo árbol como mapa mental interactivo, y estudia una rama entera en una única sesión combinada. Las barajas de cuestionarios se marcan con una insignia.

Gestiona tus barajas: crea, añade, edita, renombra y elimina barajas y tarjetas sin salir del chat. Pasa reverse al crear una baraja para practicar también cada tarjeta al revés (muy útil para vocabulario).

Solo JSON: las barajas viven en data/decks.json y se leen en vivo en cada llamada. Edítalas a mano o deja que Claude las cree. Sin base de datos, sin servicios externos.

Related MCP server: EduChain MCP Server

Las herramientas

Solo review_deck y study abren la interfaz integrada de tarjetas; todo lo demás devuelve un resumen de texto, de modo que editar o crear en el chat ya no abre el widget.

La generación de tarjetas sigue las reglas de calidad de Memora (tarjetas atómicas de un solo concepto, respuestas de 1 a 5 palabras, recuerdo activo, sin ambigüedades, sin desvelar la respuesta, aplicación frente a definición), basadas en las 20 reglas para formular conocimiento de Wozniak. Las tarjetas nuevas se revisan al guardarlas y se marcan (nunca se bloquean) para que Claude pueda corregirlas.

Cómo funciona (MCP Apps)

Una herramienta declara un recurso ui://. Cuando Claude llama a la herramienta, el host (Claude Desktop) obtiene ese recurso, renderiza su HTML en un iframe aislado, pasa el resultado de la herramienta a la interfaz, y la interfaz se comunica con el host mediante JSON-RPC (para evaluar tarjetas e informar del progreso al modelo).

Inicio rápido

Requisitos previos

• Node.js 20.11+

Conectar con Claude Desktop

Abre Settings > Developer > Edit Config y añade Memora en mcpServers:

{
  "mcpServers": {
    "memora": {
      "command": "npx",
      "args": ["-y", "@servation/memora-mcp", "--stdio"]
    }
  }
}

A continuación, cierra Claude Desktop por completo (desde la bandeja del sistema) y vuelve a abrirlo. memora aparece en Settings > Developer, precargado con algunas barajas de ejemplo.

Tus barajas se guardan en ~/.memora/decks.json (puedes sobrescribir la ruta con la variable de entorno MEMORA_DECKS). Edita ese archivo a mano o deja que Claude lo gestione.

git clone https://github.com/Servation/memora-mcp.git
cd memora-mcp
npm install
npm run build

Apunta la configuración a la entrada compilada con una ruta absoluta (las barajas viven entonces en data/decks.json del repositorio):

{
  "mcpServers": {
    "memora": {
      "command": "node",
      "args": ["C:\\path\\to\\memora-mcp\\dist\\main.js", "--stdio"]
    }
  }
}

Pruébalo (en un chat de Claude Desktop)

• review my World Capitals deck

• make me a deck of 10 Spanish travel phrases

• make a reversible deck of 10 Spanish words (practica en ambas direcciones)

• make a fill-in-the-blank deck about the water cycle (tarjetas cloze)

• quiz me with 10 multiple-choice questions on the solar system

• turn what we just discussed into a deck called "Photosynthesis"

• study my LLM category

• what's due today?

Pila tecnológica

• Servidor: TypeScript, @modelcontextprotocol/sdk más @modelcontextprotocol/ext-apps, transporte stdio (también disponible Streamable HTTP).

• Interfaz: React con Vite, empaquetado en un único archivo HTML incrustado mediante vite-plugin-singlefile.

• Programación: ts-fsrs (FSRS).

• El tiempo de ejecución es node puro una vez compilado (no se necesitan bun ni tsx).

Formato de baraja

{
  "Deck Name": [
    { "front": "Capital of France?", "back": "Paris" }
  ]
}

• Se guarda en ~/.memora/decks.json cuando está instalado (o data/decks.json desde el código fuente); se puede sobrescribir con MEMORA_DECKS.

• Se lee en vivo (con caché por mtime). create_deck, create_quiz y grade_card escriben aquí de forma atómica.

• Una tarjeta de cuestionario añade "options": ["...", "..."]; su back es la opción correcta.

• Una tarjeta cloze escribe el hueco como [...] en el anverso, con el término oculto como back.

• Las tarjetas reciben una fecha due y un bloque srs de FSRS a medida que las repasas; las tarjetas sin ellos se tratan como nuevas.

• Mantenlo como JSON válido, o el servidor recurrirá a una baraja predeterminada integrada.

Estructura del proyecto

memora-mcp/
├── server.ts            # MCP tools + the ui:// resource
├── decks.ts             # data model, decks.json storage, result builder
├── scheduling.ts        # FSRS scheduling + review ordering
├── main.ts              # entry: stdio (Claude Desktop) or Streamable HTTP
├── mcp-app.html         # UI entry HTML (bundled by Vite)
├── src/
│   ├── mcp-app.tsx      # review orchestrator (flip / quiz / cloze, grade -> model)
│   ├── deck-lib.tsx     # tree, mind map, card list, quiz/cloze views, helpers
│   ├── mcp-app.module.css
│   └── global.css       # host theme variable fallbacks (light/dark)
├── data/decks.json      # editable decks, read live
├── media/               # README images
├── vite.config.ts       # single-file bundle config
└── tsconfig*.json

Desarrollo

npm run dev        # vite watch (UI) plus tsx server on http://localhost:3001/mcp
npm run typecheck  # tsc --noEmit

Para iterar rápido en local, también puedes ejecutar la aplicación contra el host de referencia de MCP Apps (basic-host) del repositorio ext-apps.

Hoja de ruta

Consulta TODO.md para ver el trabajo pendiente: publicación en npm + MCP Registry, alojamiento entre clientes (Streamable HTTP), pruebas en torno al análisis y la planificación, y un GIF real de demostración con captura de pantalla.

Licencia

MIT