Anki MCP Server

Ein Model Context Protocol (MCP)-Server, der es LLMs ermöglicht, über AnkiConnect mit der Anki-Flashcard-Software zu interagieren.

Funktionen

Tools

• list_decks - Alle verfügbaren Anki-Decks auflisten

• create_deck - Ein neues Anki-Deck erstellen

• create_note - Eine neue Notiz erstellen (Basic oder Cloze)

• batch_create_notes - Mehrere Notizen gleichzeitig erstellen

• search_notes - Nach Notizen mit der Anki-Abfragesyntax suchen

• get_note_info - Detaillierte Informationen zu einer Notiz abrufen

• update_note - Eine bestehende Notiz aktualisieren

• delete_note - Eine Notiz löschen

• list_note_types - Alle verfügbaren Notiztypen auflisten

• create_note_type - Einen neuen Notiztyp erstellen

• get_note_type_info - Detaillierte Struktur eines Notiztyps abrufen

Ressourcen

• anki://decks/all - Vollständige Liste der verfügbaren Decks

• anki://note-types/all - Liste aller verfügbaren Notiztypen

• anki://note-types/all-with-schemas - Detaillierte Strukturinformationen für alle Notiztypen

• anki://note-types/{modelName} - Detaillierte Strukturinformationen für einen spezifischen Notiztyp

Related MCP server: Anki MCP Server

Voraussetzungen

1. Anki auf Ihrem System installiert

2. AnkiConnect Add-on in Anki installiert

Konfiguration

Installation via Desktop-Erweiterung (.mcpb)

Dieses Repository unterstützt Anthropic Desktop Extensions (MCPB). Der einfachste Weg, diesen Server in Claude Desktop zu verwenden, ist die Installation des gepackten .mcpb-Bundles.

1. Generieren Sie die .mcpb-Datei lokal mit dem bereitgestellten Skript:

npm run pack

2. Öffnen Sie Claude Desktop Einstellungen → Erweiterungen, ziehen Sie die generierte .mcpb-Datei hinein und klicken Sie auf Installieren.

Dies validiert manifest.json und gibt ein .mcpb-Archiv aus, das Sie wie oben beschrieben installieren können. Erfahren Sie mehr über Desktop-Erweiterungen in der Ankündigung von Anthropic: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Verwendung mit Claude Desktop

Fügen Sie den Server zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server"]
    }
  }
}

Verwendung eines benutzerdefinierten AnkiConnect-Ports

Wenn Ihr AnkiConnect auf einem anderen Port läuft, können Sie diesen mit dem Parameter --port angeben:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

Konfiguration für Cline

Fügen Sie den Server zu Ihrer Cline MCP-Einstellungsdatei innerhalb der VSCode-Einstellungen cline_mcp_settings.json hinzu

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server"]
    }
  }
}

Verwendung eines benutzerdefinierten AnkiConnect-Ports

Für Cline können Sie ebenfalls einen benutzerdefinierten Port angeben:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

Agent-Fähigkeiten (Claude Code)

Installieren Sie die Anki-Fähigkeit, um Claude Code integriertes Wissen über alle Anki-Tools und Workflows zu geben:

npx skills add nailuoGG/anki-mcp-server@anki

Sobald installiert, wird Claude Code die Fähigkeit automatisch verwenden, wenn Sie ihn bitten, Karteikarten zu erstellen, Decks zu verwalten oder Notizen stapelweise zu importieren.

Hinweis: Verwenden Sie nicht die .mcpb-gepackte Version als MCP-Server — sie gibt Electron-Metadaten an stdout aus, was das MCP-stdio-Protokoll unterbricht. Verwenden Sie stattdessen npx -y anki-mcp-server.

Entwicklung

Packen einer Desktop-Erweiterung (.mcpb)

Erstellen Sie ein verteilbares Desktop-Erweiterungs-Bundle für Claude Desktop:

npm run pack

Dies baut das Projekt und generiert ein .mcpb-Archiv aus dem aktuellen Repository, wobei manifest.json validiert wird. Testen Sie es, indem Sie es in die Erweiterungseinstellungen von Claude Desktop ziehen. Referenz: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Veröffentlichung in der MCP-Registry

Dieser Server wird automatisch in der MCP-Registry veröffentlicht, wenn eine neue Version veröffentlicht wird. Der Veröffentlichungsprozess umfasst:

1. Automatisierte CI/CD: GitHub Actions veröffentlicht bei erfolgreichen Releases automatisch sowohl auf NPM als auch in der MCP-Registry

2. Schema-Validierung: Die server.json-Datei wird vor der Veröffentlichung gegen das MCP-Schema validiert

3. Versionssynchronisation: Versionen werden zwischen package.json, manifest.json und server.json synchron gehalten

4. Umfassende Tests: Multi-Version Node.js-Tests, Linting und Validierung vor der Veröffentlichung

5. Beta-Support: Automatisierte Beta-Releases zum Testen neuer Funktionen

Manuelle Validierung

Sie können die MCP-Serverkonfiguration lokal validieren:

npm run validate-mcp

Dies lädt das neueste MCP-Schema herunter und validiert Ihre server.json-Datei.

Manuelle Veröffentlichung

Wenn Sie manuell veröffentlichen müssen, können Sie das MCP Publisher CLI verwenden:

# Install MCP Publisher
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
chmod +x mcp-publisher
sudo mv mcp-publisher /usr/local/bin/

# Login to MCP Registry
mcp-publisher login github-oidc

# Publish to MCP Registry
mcp-publisher publish

Einrichtung

1. Abhängigkeiten installieren:

npm install

2. Server bauen:

npm run build

3. Für die Entwicklung mit automatischem Neuaufbau:

npm run watch

Testen

Führen Sie die Test-Suite aus:

npm test

Dies führt Tests durch für:

• Server-Initialisierung

• AnkiConnect-Kommunikation

• Notiz-Operationen (Erstellen/Lesen/Aktualisieren/Löschen)

• Deck-Verwaltung

• Fehlerbehandlung

Debugging

Da MCP-Server über stdio kommunizieren, empfehlen wir die Verwendung des MCP Inspector:

npm run inspector

Dies bietet eine browserbasierte Schnittstelle für:

• Überwachung von MCP-Nachrichten

• Testen von Tool-Aufrufen

• Anzeigen von Server-Logs

• Debugging von Kommunikationsproblemen

Beispielanwendung

1. Ein neues Deck erstellen:

Create a new Anki deck called "Programming"

2. Eine Basiskarte hinzufügen:

Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.

3. Eine Cloze-Lückentextkarte hinzufügen:

Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Branch

3. Führen Sie Tests aus: npm test

4. Senden Sie einen Pull Request

Star-Verlauf

Credits

Icon mit freundlicher Genehmigung von macOS Icons

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details