Skip to main content
Glama

srs-mcp – Spaced Repetition, als MCP-Server

Gib jedem MCP-fähigen Agenten (Claude Code, Claude Desktop oder einem anderen MCP-Host) echtes, korrekt geplantes Spaced-Repetition-Gedächtnis, anstatt „was heute fällig ist“ jede Sitzung manuell aus einer Markdown-Tabelle abzuleiten. Implementiert SM-2 (den Algorithmus hinter Anki/SuperMemo) als vier aufrufbare Tools, unterstützt durch eine lokale SQLite-Datei. Kein Konto, keine Netzwerkaufrufe, keine Telemetrie – alles läuft auf deinem Rechner.

Status: Prototyp, noch nirgendwo veröffentlicht. Lokal gebaut und verifiziert (siehe „Wie es verifiziert wurde“ unten); noch von niemandem außerhalb dieses Projekts installiert. Behandle Version 0.2.0 als Vorabversion.

Warum es das gibt

Markdown-Checklisten und Vokabeltabellen sind gängige Methoden, mit denen Menschen (und die sie unterstützenden Agenten) verfolgen, was zu wiederholen ist, aber nichts berechnet daraus einen tatsächlichen Zeitplan – „heute fällig“ wird zu einer Vermutung, die jedes Mal von Hand nachgelesen wird. srs-mcp ist das fehlende Puzzleteil: ein kleiner, echter Planungsalgorithmus, der als Tools bereitgestellt wird, sodass ein Agent den Wiederholungsstatus für alles verfolgen kann – Karteikarten, Interviewfragen, Vokabeln, Onboarding-Quizze – ohne SM-2 in einem Prompt neu zu implementieren.

Related MCP server: FlashLearn

Die vier Kern-Tools (kostenlos, unbegrenzt, für immer)

Tool

Was es tut

add_item(topic, question, answer)

Fügt ein Wiederholungselement unter einem Thema hinzu. Neue Elemente sind sofort fällig.

get_due_items(topic="", limit=10)

Listet heute fällige oder überfällige Elemente auf. Antwort wird bis zur Bewertung zurückgehalten, wie bei einer echten Karteikarten-Wiederholung.

grade_item(item_id, quality)

Bewertet die Erinnerung mit 0–5 (5 = perfekt, <3 = nicht bestanden/zurücksetzen). Gibt das nächste Fälligkeitsdatum via SM-2 und die richtige Antwort zurück.

get_stats(topic="")

Gesamtzahlen, Anzahl heute fällig, durchschnittlicher Leichtigkeitsfaktor.

Pro erhalten

Zwei zusätzliche Tools sind hinter einer Pro-Lizenz gesperrt – das ist die kostenlos/bezahlt-Aufteilung, die srs-mcp anstelle von Abonnements oder einem gehosteten Backend verwendet:

Tool

Was es tut

export_items(topic="", format="json"|"csv")

Massenexport/-sicherung aller deiner Wiederholungsdaten.

get_forecast(topic="", days=30)

Prognose der Wiederholungslast – wie viele Elemente an jedem der nächsten N Tage fällig werden, damit ein Stau sichtbar wird, bevor er passiert.

So funktioniert die Lizenzierung konkret: srs-mcp signiert Lizenzschlüssel mit einem privaten Ed25519-Schlüssel, der den Rechner des Maintainers nie verlässt; dieses Repository enthält nur den passenden öffentlichen Schlüssel (license.py), der eine Signatur verifizieren, aber keine fälschen kann. Kaufe einen Schlüssel, setze ihn als SRS_LICENSE_KEY (Umgebungsvariable) oder speichere ihn unter ~/.srs-mcp/license.key, und die Pro-Tools werden freigeschaltet – kein Konto, kein Phone-Home-Check, funktioniert offline. Siehe license.py für den vollständigen Mechanismus und seine genannten Einschränkungen (Kurzfassung: Das schreckt gelegentliches Kopieren ab, es ist kein DRM – nichts hindert jemanden daran, die Prüfung in seiner eigenen lokalen Kopie einer Open-Source-Python-Datei zu entfernen; siehe den Docstring des Moduls für die ehrliche Version dieses Kompromisses).

Es gibt noch keinen aktiven Kauf-Link. Dieser Abschnitt beschreibt den Mechanismus, der gebaut und getestet ist (siehe test_license_gate.py), keinen funktionierenden Shop. Wenn ein Kaufablauf existiert, kommt er hierher.

Installation

Erfordert Python 3.11+.

git clone <repo-url>   # not yet public — see status note above
cd srs-mcp
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/srs-mcp       # runs the server on stdio

Um es als Claude-Code-Plugin zu verwenden, richte Claude Code auf dieses Verzeichnis (oder, sobald veröffentlicht, auf seinen Marketplace-Eintrag) – .claude-plugin/plugin.json und .mcp.json sind bereits eingerichtet; der Server liest SRS_DB_PATH, sodass die Daten einer Plugin-Installation Updates überleben (${CLAUDE_PLUGIN_DATA}/srs.db unter Claude Code oder eine srs.db am selben Ort für einen direkten/manuellen Lauf).

Wie es verifiziert wurde

Nicht nur „es importiert“ – tatsächlich ausgeführt, über das echte MCP-Protokoll:

  • test_client.py startet server.py als Unterprozess (genau wie ein echter MCP-Host), führt eine vollständige add/list/grade/list-Sitzung durch und überprüft unabhängig die resultierenden SQLite-Zeilen außerhalb der Testumgebung.

  • test_license_gate.py startet den Server auf drei Arten (keine Lizenz, gültige Lizenz, manipulierte Lizenz) und bestätigt, dass export_items / get_forecast in den Fällen 1 und 3 verweigern und in Fall 2 echte Daten zurückgeben – was beweist, dass die Lizenzprüfung ein echtes Tor ist, kein No-op.

  • ingest_chinese_vocab.py und ingest_leetcode.py sind funktionierende, idempotente Ingestionsskripte, die echte persönliche Daten (114 chinesische Vokabeln, 16 abgeschlossene LeetCode-Aufgaben) aus den Markdown-Trackern dieses Projekts über echte add_item-MCP-Aufrufe einspeisen, nicht über direkte SQLite-Schreibvorgänge.

Ehrliche Lücke bis „startklar“ – nicht aufgerundet

  1. Kein öffentliches Repository. Jeder echte Verteilungspfad (Claude Codes Community-Plugin-Marketplace, ein GitHub-Release, ein MCP-Verzeichniseintrag) benötigt, dass dies unter einer öffentlichen Git-URL erreichbar ist. Dieses Projekt ist nur lokal. Das zu erstellen (ein GitHub-Repository, möglicherweise ein Konto) liegt außerhalb der aktuellen Autonomie dieses Projekts ohne ausdrückliche Genehmigung – alles oben Genannte ist darauf vorbereitet, dies zu einer Kopier-und-Push-Aktion zu machen, nicht zu einer Build-Aufgabe, sobald die Genehmigung erteilt ist.

  2. Kann sich nicht gegen claude plugin validate selbst validieren. Keine claude-CLI oder Node/npx in dieser Entwicklungsumgebung verfügbar. Das Plugin-Manifest ist schema-konform, soweit sorgfältiges Lesen der Anthropic-Dokumentation und Querverweise auf deren eigenes Produktions-marketplace.json bestätigen können, nicht maschinell validiert.

  3. Kein aktiver Kaufablauf. Der Lizenzmechanismus ist echt und getestet; ihn in einen tatsächlichen Verkauf zu verwandeln, benötigt einen Storefront (Ko-fi, Gumroad oder ähnlich), der noch nicht existiert – das ist ein Schritt zur Kontoerstellung, außerhalb der Autonomie dieses Projekts ohne Genehmigung.

  4. Die Lizenzdurchsetzung basiert auf Ehrlichkeit, nicht auf Manipulationssicherheit, by design und durch die Natur des Auslieferns von lesbarem Python – siehe den Abschnitt „Pro erhalten“ oben und den Docstring von license.py.

  5. Kein Auth-/Multi-Tenant-Ansatz. Einzelne lokale SQLite-Datei, einzelner Benutzer. In Ordnung für das aktuelle Modell „läuft auf deinem Rechner“; würde echte Designarbeit erfordern, um ein gehostetes/Team-Produkt zu werden.

  6. Null externe Validierung. Niemand außerhalb dieses Projekts hat dies installiert oder verwendet. Jede obige Behauptung ist „das funktioniert wie gebaut und getestet“, nicht „Leute wollen das“.

Lizenz

MIT – siehe LICENSE. (Der Lizenzschlüsselmechanismus der Pro-Stufe ist getrennt von der MIT-Lizenz des Codes – siehe „Pro erhalten“ oben.)

Available Tools

6 tools
add_itemA

Add a new spaced-repetition item (e.g. a LeetCode problem, a Chinese vocab word, an interview question) under a topic. New items are due immediately.

Inputs: topic (required), answer (required), question (required).

export_itemsA

[Pro] Export items (id, topic, question, answer, interval_days, repetitions, ease_factor, due_date, created_at) as json or csv text, optionally filtered to one topic. Requires a valid Pro license (see README's "Get Pro" section) -- this is the free/Pro split's first concrete gate: the 4 core tools stay free and unlimited forever, bulk export/backup is part of the paid tier. Without a valid license, returns an upgrade message instead of data, not an error the caller has to guess the meaning of.

Inputs: topic, format.

get_due_itemsA

List items due for review today (or overdue), optionally filtered to one topic. Returns id, topic, question (answer withheld until grade_item is called, same as a real flashcard review).

Inputs: limit, topic.

get_forecastA

[Pro] Review-load forecast: how many items become due on each of the next N days, optionally filtered to one topic. Lets a user see an upcoming pile-up before it happens instead of discovering it the day of -- a real planning feature, not a gate for its own sake. Requires a valid Pro license, same as export_items.

Inputs: days, topic.

get_statsA

Summary stats: total items, how many due today, average ease factor, optionally scoped to one topic.

Inputs: topic.

grade_itemA

Grade recall quality for an item just reviewed (0-5: 0 = total blackout, 3 = correct with effort, 5 = perfect instant recall) and return the newly computed next-due date, plus the correct answer for confirmation. Uses SM-2 scheduling.

Inputs: item_id (required), quality (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool serves a clearly distinct purpose: adding items, fetching due items, grading recall, viewing stats, exporting data, and forecasting workload. There is no overlap or ambiguity in their intended actions.

    Naming Consistency5/5

    Every tool follows a consistent verb_noun pattern (add_item, get_due_items, grade_item, get_stats, export_items, get_forecast), making it easy to infer the action and target. No mixed conventions or vague verbs.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a spaced-repetition system, covering the core workflows (add, review, stats, export, forecast) without unnecessary bloat or excessive granularity.

    Completeness4/5

    The tool surface covers the primary lifecycle (add, review, stats, export, forecast) well, but lacks direct update and delete operations for items. Export tools can serve as a workaround, so the gap is minor.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables agents to perform spaced-repetition learning with FSRS scheduling, including adding cards, reviewing due cards, and grading recall, using a headless SQLite or Postgres backend.
      9
      34 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Local Leitner flashcard MCP server enabling AI clients to create decks, manage cards, study with spaced repetition, and track progress.
      MIT