Anki MCP

🧠 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“

🎯 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 Yanki-Connect- Bibliothek für die Bereitstellung der robusten AnkiConnect-Schnittstelle, die diese Integration ermöglicht!

📋 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

1. Öffnen Sie Anki
2. Gehen Sie zu Extras → Add-ons
3. Klicken Sie auf „Add-ons abrufen …“
4. Code eingeben: 2055492159
5. Starten 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:

1. Gehen Sie zu Extras → Add-ons
2. Wählen Sie AnkiConnect und klicken Sie auf „Konfigurieren“
3. Die Standardeinstellungen sollten für die meisten Benutzer gut funktionieren

🚀 Schnellstart

Option 1: Verwendung mit Claude Desktop (empfohlen)

1. Installieren des Pakets
   npm install -g @arielbk/anki-mcp
2. Claude Desktop konfigurierenBearbeiten 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": [] } } }
3. Starten Sie Claude Desktop neu
4. 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

1. Klonen Sie das Repository
   git clone https://github.com/arielbk/anki-mcp.git cd anki-mcp
2. Abhängigkeiten installieren
   pnpm install
3. Erstellen des Projekts
   pnpm build
4. Testen 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:

🎮 Anwendungsbeispiele

Nach der Konfiguration mit Claude Desktop können Sie natürliche Gespräche führen wie:

📖 Lernsitzungen

📝 Inhaltserstellung

📊 Studienanalyse

🏷️ Organisation

🔧 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

🔧 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:

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-mcp korrekt funktioniert hat

🤝 Beitragen

Wir freuen uns über Beiträge! Bitte:

1. Forken Sie das Repository
2. Erstellen eines Feature-Zweigs
3. Nehmen Sie Ihre Änderungen vor
4. Fügen Sie gegebenenfalls Tests hinzu
5. 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! 🚀