Memora MCP

Превратите любой разговор в интерактивное учебное занятие прямо в Claude Desktop. Попросите Claude создать колоду — и он сгенерирует карточки, затем отобразит их как встроенный обзор, по которому можно кликать: переворачивайте флеш-карточки, отвечайте на вопросы с множественным выбором и заполняйте пропуски в cloze-карточках. Каждый ответ обновляет расписание интервального повторения, а ваши результаты возвращаются к Claude, чтобы он мог отработать то, что вы пропустили.

Ключевые слова: Model Context Protocol, MCP-сервер, MCP Apps, Claude Desktop, флеш-карточки, викторины, интервальное повторение, SRS, FSRS, альтернатива Anki.

Построено на расширении MCP Apps (SEP-1865): базовая спецификация MCP 2025-11-25 плюс расширение Apps 2026-01-26.

Возможности

Три способа учиться — все отображаются встроенно и оцениваются одинаково:

• Флеш-карточки: нажмите, чтобы перевернуть, затем оцените Понял / Не понял.

• Викторины с множественным выбором: выберите вариант, и правильный/неправильный ответы раскроются мгновенно.

• Cloze (заполнение пропусков): пропуск раскрывается на месте, чтобы предложение оставалось целым. Напишите пропуск как [...] на лицевой стороне карточки, и она автоматически станет cloze-карточкой.

Интервальное повторение: каждая оценка обновляет индивидуальное расписание FSRS для карточки (через ts-fsrs), поэтому слабые карточки всплывают раньше, а просроченные идут первыми. Спросите «что сегодня на повторении?» для сводки по всем вашим колодам.

Организация с категориями: называйте колоды с :: для вложенности (например, LLM::Attention). Просматривайте дерево категорий или то же дерево как интерактивную интеллект-карту и учите целую ветку в одном объединённом сеансе. Колоды-викторины помечаются значком.

Управление колодами: создавайте, дополняйте, редактируйте, переименовывайте и удаляйте колоды и карточки, не выходя из чата. Передайте reverse при создании колоды, чтобы также отрабатывать каждую карточку в обратную сторону (удобно для словарного запаса).

Просто JSON: колоды хранятся в data/decks.json и читаются в реальном времени при каждом вызове. Редактируйте их вручную или позвольте Claude создавать их. Никакой базы данных, никакого внешнего сервиса.

Related MCP server: EduChain MCP Server

Инструменты

Только review_deck и study открывают встроенный интерфейс переворачивающихся карточек; всё остальное возвращает текстовую сводку, поэтому редактирование или создание в чате больше не открывает виджет.

Генерация карточек следует правилам качества Memora (атомарные карточки с одной концепцией, ответы из 1–5 слов, активное припоминание, однозначность, отсутствие утечки ответов, применение вместо определения), основанным на 20 правилах формулирования знаний Возняка. Новые карточки проверяются при записи и помечаются (но никогда не блокируются), чтобы Claude мог их пересмотреть.

Как это работает (MCP Apps)

Инструмент объявляет ресурс ui://. Когда Claude вызывает инструмент, хост (Claude Desktop) загружает этот ресурс, отображает его HTML в песочнице iframe, передаёт результат инструмента в интерфейс, а интерфейс общается с хостом через JSON-RPC (для оценки карточек и отчёта о прогрессе модели).

Быстрый старт

Предварительные требования

• Node.js 20.11+

Подключение к Claude Desktop

Откройте Настройки > Разработчик > Изменить конфигурацию и добавьте Memora в раздел mcpServers:

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

Затем полностью закройте Claude Desktop (из системного трея) и запустите заново. memora появится в разделе Настройки > Разработчик, предварительно загруженный с несколькими примерами колод.

Ваши колоды хранятся в ~/.memora/decks.json (переопределите путь переменной окружения MEMORA_DECKS). Редактируйте этот файл вручную или позвольте Claude управлять им.

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

Укажите в конфигурации путь к собранной точке входа с абсолютным путём (колоды тогда будут храниться в data/decks.json репозитория):

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

Попробуйте (в чате Claude Desktop)

• просмотри мою колоду World Capitals

• сделай мне колоду из 10 испанских фраз для путешествий

• сделай обратимую колоду из 10 испанских слов (отрабатывает оба направления)

• сделай колоду с заполнением пропусков о круговороте воды (cloze-карточки)

• проверь меня 10 вопросами с множественным выбором о солнечной системе

• преврати то, что мы только что обсудили, в колоду под названием "Фотосинтез"

• изучи мою категорию LLM

• что сегодня на повторении?

Технологический стек

• Сервер: TypeScript, @modelcontextprotocol/sdk плюс @modelcontextprotocol/ext-apps, транспорт stdio (Streamable HTTP также доступен).

• Интерфейс: React плюс Vite, собранный в единый встроенный HTML-файл через vite-plugin-singlefile.

• Планирование: ts-fsrs (FSRS).

• Среда выполнения — обычный node после сборки (bun или tsx не нужны).

Формат колоды

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

• Хранится в ~/.memora/decks.json при установке (или data/decks.json из исходного кода); переопределяется через MEMORA_DECKS.

• Читается в реальном времени (с кэшированием по mtime). create_deck, create_quiz и grade_card записывают сюда атомарно.

• Викторина-карточка добавляет "options": ["...", "..."]; её back — правильный вариант.

• Cloze-карточка записывает пропуск как [...] на лицевой стороне, со скрытым термином в back.

• Карточки получают дату due и блок FSRS srs по мере повторения; карточки без них считаются новыми.

• Поддерживайте корректный JSON, иначе сервер вернётся к встроенной колоде по умолчанию.

Структура проекта

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

Разработка

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

Для быстрой локальной итерации вы также можете запустить приложение против эталонного хоста MCP Apps (basic-host) из репозитория ext-apps.

Дорожная карта

См. TODO.md для бэклога: публикация в npm и MCP Registry, кроссплатформенный хостинг (Streamable HTTP), тесты для парсинга и планирования, а также реальная GIF-демонстрация захвата экрана.

Лицензия

MIT