🧠 Anki MCP
Verwandeln Sie Ihr Anki-Karteikarten-Erlebnis mit KI! Dieser MCP-Server (Model Context Protocol) verbindet Ihre Anki-Karteikartensammlung mit KI-Assistenten wie Claude und ermöglicht so natürliche Gespräche über Ihre Lernmaterialien.
🚀 Was können Sie tun?
Stellen Sie sich vor, Sie hätten einen KI-Tutor, der Ihre gesamte Karteikartensammlung kennt und Folgendes kann:
📚 Interaktives Lernen
„Testen Sie mich mit japanischen Vokabeln, die ich seit drei Tagen nicht mehr gesehen habe.“
„Testen Sie mich mit anspruchsvollen Karten aus meinem Medizindeck“
„Zeigen Sie mir Karten, mit denen ich in letzter Zeit Probleme hatte.“
✨ Intelligente Inhaltserstellung
"Erstellen Sie Lernkarten zur Photosynthese mit Diagrammen"
„Verwandeln Sie dieses PDF-Kapitel in verteilte Wiederholungskarten.“
„Lückentext-Löschkarten aus meinen Vorlesungsmitschriften erstellen“
🔍 Leistungsstarke Analysen
„Mit welchen Themen habe ich am meisten zu kämpfen?“
„Zeigen Sie mir meine Lernmuster des letzten Monats“
„Wie hoch ist meine Bindungsrate für verschiedene Kartentypen?“
🎯 Massenvorgänge
„Tagge alle meine Chemiekarten mit ‚Prüfungsvorbereitung‘“
„Verschieben Sie Karten mit geringer Merkfähigkeit in ein intensives Wiederholungsdeck.“
„Finde und behebe doppelte Karten in meinen Decks“
Related MCP server: Maya MCP
🎯 Funktionen
Vollständige Anki-Integration : Vollständiger Zugriff auf Decks, Karten, Notizen und Statistiken über alle 115 AnkiConnect-API-Methoden
Konversationsschnittstelle : Natürliche Sprachbefehle über Ihren KI-Assistenten
Massenvorgänge : Verwalten Sie Tausende von Karten gleichzeitig effizient
Echtzeitstatistiken : Erhalten Sie Einblicke in Ihren Lernfortschritt
Medienunterstützung : Verarbeiten Sie Bilder, Audio und andere Medien auf Ihren Karten
Erweiterte Abfragen : Finden Sie Karten mithilfe komplexer Suchkriterien
Typsicherheit : Vollständig typisierte API mit umfassender Fehlerbehandlung
🛠 Technischer Stack
Node.js : Laufzeitumgebung (ab 18 Jahren erforderlich)
TypeScript : Typsicherheit und Entwicklererfahrung
MCP SDK : Implementierung des Model Context Protocol
yanki-connect : 🙏 Vollständig typisierter, isomorpher AnkiConnect-API-Client
tsup : Schneller TypeScript-Bündeler
PNPM : Effizienter Paketmanager
Besonderer Dank gilt der
📋 Voraussetzungen
1. Anki installieren
Laden Sie Anki herunter und installieren Sie es, falls Sie dies noch nicht getan haben.
2. Installieren Sie das AnkiConnect-Plugin
Öffnen Sie Anki
Gehen Sie zu Extras → Add-ons
Klicken Sie auf „Add-ons abrufen …“
Code eingeben:
2055492159Starten Sie Anki neu
📋 Versionsanforderungen: Dieser Server benötigt AnkiConnect Version 25.2.25.0 oder neuer (veröffentlicht am 25.02.2025) für volle Kompatibilität. Die meisten Funktionen funktionieren mit älteren Versionen, wir empfehlen jedoch ein Update für ein optimales Erlebnis.
3. AnkiConnect konfigurieren (optional)
AnkiConnect funktioniert sofort, Sie können die Einstellungen jedoch anpassen:
Gehen Sie zu Extras → Add-ons
Wählen Sie AnkiConnect und klicken Sie auf „Konfigurieren“
Die Standardeinstellungen sollten für die meisten Benutzer gut funktionieren
🚀 Schnellstart
Option 1: Verwendung mit Claude Desktop (empfohlen)
Installieren des Pakets
npm install -g @arielbk/anki-mcpClaude Desktop konfigurieren
Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
macOS :
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows :%APPDATA%\Claude\claude_desktop_config.jsonFügen Sie diese Konfiguration hinzu:
{ "mcpServers": { "anki": { "command": "anki-mcp", "args": [] } } }Starten Sie Claude Desktop neu
Fangen Sie an, es zu verwenden!
Stellen Sie sicher, dass Anki mit aktiviertem AnkiConnect ausgeführt wird
Fragen Sie Claude: „Zeigen Sie mir meine Anki-Decks“ oder „Questieren Sie mich mit 5 Karten ab“
💡 Profi-Tipp: Sie können Ihr Setup testen, indem Sie Claude einfache Fragen stellen wie „Wie viele Anki-Decks habe ich?“ oder „Was ist in meinem größten Deck?“
Option 2: Entwicklungs-Setup
Klonen Sie das Repository
git clone https://github.com/arielbk/anki-mcp.git cd anki-mcpAbhängigkeiten installieren
pnpm installErstellen des Projekts
pnpm buildTesten des Servers
# Use the MCP inspector to test functionality pnpm inspect
Option 3: Verwendung mit anderen MCP-Clients
Dieser Server funktioniert mit jedem MCP-kompatiblen Client. Sie können ihn auch verwenden mit:
MCP Inspector : Interaktives Debugging-Tool
Cline : VS Code-Erweiterung für KI-Codierung
Benutzerdefinierte MCP-Clients : Erstellen Sie Ihren eigenen mit dem MCP SDK
Führen Sie für den Stdio-Transport Folgendes aus:
node dist/index.js🎮 Anwendungsbeispiele
Nach der Konfiguration mit Claude Desktop können Sie natürliche Gespräche führen wie:
📖 Lernsitzungen
You: "I have a Japanese exam tomorrow. Can you quiz me on Hiragana cards I haven't reviewed in a week?"
Claude: I'll find your Hiragana cards that need review and start a quiz session...📝 Inhaltserstellung
You: "Create flashcards for the major battles of World War II with dates and significance"
Claude: I'll create comprehensive flashcards covering the key WWII battles...📊 Studienanalyse
You: "How am I doing with my medical terminology deck? Show me my weak areas."
Claude: Let me analyze your performance on the medical terminology deck...🏷️ Organisation
You: "Tag all cards about cardiovascular system with 'cardiology' and move them to my MCAT prep deck"
Claude: I'll help you organize those cards...🔧 Verfügbare Tools und Ressourcen
Dieser MCP-Server bietet umfassenden Zugriff auf Ihre Anki-Sammlung durch diese Funktionen:
📚 Deckverwaltung
Liste aller Decks mit Statistiken
Neue Decks erstellen
Decks umbenennen und löschen
Deckkonfiguration abrufen
🗂️ Kartenoperationen
Karten anhand von Suchkriterien finden
Antwortkarten (Bewertungen simulieren)
Erhalten Sie Karteninformationen und Statistiken
Karten sperren/entsperren
Massenkartenvorgänge
📝 Notizverwaltung
Neue Notizen mit benutzerdefinierten Feldern hinzufügen
Vorhandene Notizen aktualisieren
Notizen löschen
Notizen per Suchanfrage finden
Massennotizvorgänge
📊 Statistiken & Analysen
Deckstatistiken und Leistungsmetriken
Kartenease- und Intervalldaten
Überprüfen Sie Verlauf und Muster
Einblicke in den Lernfortschritt
🎨 Medien & Models
Zugriffsnotiztypen und Felddefinitionen
Mediendateiverwaltung
Unterstützung für die Vorlagenanpassung
🔍 Erweiterte Funktionen
Komplexe Suchanfragen mit Ankis Suchsyntax
Stapelverarbeitung für mehr Effizienz
Echtzeitsynchronisierung mit Anki
Fehlerbehandlung und Validierung
Organisierte API-Methoden, gruppiert nach Funktionalität (Karten, Decks, Notizen, Modelle, Statistiken, Medien usw.)
Direkter Zugriff auf alle 115 AnkiConnect API-Methoden mit vollständiger Typsicherheit
🛠 Entwicklung
# Run in development mode with auto-reloading
pnpm dev
# Lint the code
pnpm lint
# Format the code
pnpm format
# Test with MCP inspector
pnpm inspect🔧 Konfiguration
AnkiConnect-Einstellungen
Der Server verbindet sich standardmäßig mit AnkiConnect auf localhost:8765 . Wenn Sie Ihre AnkiConnect-Konfiguration angepasst haben, müssen Sie möglicherweise die Verbindungseinstellungen anpassen.
Wichtig : Stellen Sie sicher, dass Anki läuft und AnkiConnect installiert ist, bevor Sie den MCP-Server verwenden. Der Server kann keine Verbindung herstellen, wenn AnkiConnect nicht erreichbar ist.
💡 Hinweis: Die zugrunde liegende Yanki-Connect-Bibliothek unterstützt den automatischen Start von Anki unter macOS, diese Funktion ist jedoch derzeit nicht in der MCP-Serverkonfiguration verfügbar. Sie müssen Anki manuell starten.
Erweiterte Konfiguration von Claude Desktop
Für fortgeschrittene Benutzer können Sie zusätzliche Parameter übergeben:
{
"mcpServers": {
"anki": {
"command": "anki-mcp",
"args": ["--verbose"],
"env": {
"ANKI_CONNECT_HOST": "localhost",
"ANKI_CONNECT_PORT": "8765"
}
}
}
}Fehlerbehebung
Häufige Probleme:
„Verbindung zu AnkiConnect fehlgeschlagen“ : Stellen Sie sicher, dass Anki ausgeführt wird und das AnkiConnect-Plugin installiert ist
„Keine Decks gefunden“ : Stellen Sie sicher, dass Sie mindestens ein Deck in Anki haben
Claude antwortet nicht : Starten Sie Claude Desktop nach Konfigurationsänderungen neu
Berechtigungsfehler : Überprüfen Sie, ob die globale npm-Installation mit
npm list -g @arielbk/anki-mcpkorrekt funktioniert hat
🤝 Beitragen
Wir freuen uns über Beiträge! Bitte:
Forken Sie das Repository
Erstellen eines Feature-Zweigs
Nehmen Sie Ihre Änderungen vor
Fügen Sie gegebenenfalls Tests hinzu
Senden einer Pull-Anfrage
📜 Lizenz
MIT – Einzelheiten finden Sie in der Datei LICENSE .
🙏 Danksagungen
yanki-connect – Ausgezeichneter TypeScript-Client für AnkiConnect
AnkiConnect – Das Plugin, das Anki-Automatisierung ermöglicht
Model Context Protocol – Ermöglicht nahtlose KI-Integrationen
Verwandeln Sie Ihr Karteikarten-Erlebnis mit KI-gestützten Konversationen! 🚀