anki-mcp

Ein schlanker Model Context Protocol (MCP)-Adapter, der es KI-Assistenten (Claude Code, Hermes Agent usw.) ermöglicht, Anki-Karten direkt zu erstellen und zu verwalten – über AnkiConnect.

Keine eigene KI-App. Die KI bleibt die Intelligenzschicht; dieser Server ist nur eine Brücke zu Anki.

Claude Code / Hermes / ChatGPT
          │  MCP (stdio)
          ▼
    anki-mcp server
          │  AnkiConnect HTTP (localhost:8765)
          ▼
    Anki Desktop + AnkiConnect add-on
          │  sync
          ▼
       AnkiWeb ──► Anki mobile (iOS/Android)

Features

Related MCP server: Anki MCP Server

Einrichtung

1. Anki Desktop installieren

Von https://apps.ankiweb.net/ herunterladen und installieren. Einmal starten und mit dem AnkiWeb-Konto synchronisieren, damit die mobile Synchronisierung funktioniert.

2. Das AnkiConnect-Add-on installieren

AnkiConnect stellt Anki über eine lokale HTTP-API auf localhost:8765 bereit.

Option A – Anki-Add-on-Browser (am einfachsten):

1. In Anki: Extras → Add-ons → Add-ons abrufen…

2. Den Code 2055492159 eingeben und installieren.

Option B – manuell (Git):

cd "$APPDATA/Anki2/addons21"           # Windows
# or: ~/.local/share/Anki2/addons21   (Linux)
# or: ~/Library/Application Support/Anki2/addons21  (macOS)

git clone --depth 1 https://github.com/FooSoft/anki-connect.git 2055492159
cd 2055492159
cp plugin/*.py plugin/*.json plugin/*.md .
rm -rf plugin tests .git 2>/dev/null

3. Anki neu starten. Prüfen, dass es läuft:

curl -s http://127.0.0.1:8765 -X POST -d '{"action":"version","version":6}'
# → {"result": 6, "error": null}

3. Den MCP-Server starten

pip install mcp
python server.py

Der Server spricht MCP über stdio. Anki Desktop muss laufen (mit geladenem AnkiConnect), damit die Tools funktionieren.

In einem Client konfigurieren

Hermes Agent

Zu ~/.hermes/config.yaml hinzufügen (oder %USERPROFILE%\AppData\Local\hermes\config.yaml unter Windows):

mcp_servers:
  anki:
    command: python
    args:
      - /absolute/path/to/server.py
    timeout: 60
    connect_timeout: 30

Dann MCP in der Sitzung neu laden (/reload-mcp) oder neu starten. Die Tools erscheinen als mcp_anki_*.

Claude Code

claude mcp add anki -- python /absolute/path/to/server.py

Verwendung

Sobald alles eingerichtet ist, sag der KI einfach, was du möchtest:

"Füge eine Karte zu meinem System-Design-Deck hinzu: Vorderseite = 'Warum verwendet konsistentes Hashing virtuelle Knoten?', Rückseite = 'Um Schlüssel gleichmäßiger zu verteilen.'" "Erstelle Anki-Karten aus den wichtigen Konzepten, die wir gerade besprochen haben."

Regeln für die Kartenerstellung (Füge diese in deine KI-Anweisungen ein)

• Ein Konzept pro Karte.

• Fragen bevorzugen, die Erinnerung erfordern.

• Sehr lange Antworten vermeiden.

• Keine Karten für triviale Fakten erstellen.

• Wo passend Lückentext-Karten verwenden.

• Quellen-/Themen-Tags hinzufügen.

Auf das Handy synchronisieren

MCP-erstellte Karten bleiben in Anki Desktop, bis du synchronisierst. Synchronisierung auslösen:

• Manuell: Anki → Synchronisieren (oder Y drücken), oder

• Über AnkiConnect: curl -s http://127.0.0.1:8765 -X POST -d '{"action":"sync","version":6}'

Dann die Anki-Mobil-App synchronisieren, um die neuen Karten zu übernehmen.

Voraussetzungen

• Python 3.10+

• mcp-Paket (pip install mcp)

• Anki Desktop (läuft)

• AnkiConnect-Add-on

Lizenz

MIT