anki-mcp

Un adaptador ligero de Model Context Protocol (MCP) que permite a los asistentes de IA (Claude Code, Hermes Agent, etc.) crear y gestionar tarjetas de Anki directamente, a través de AnkiConnect.

Sin aplicación de IA personalizada. La IA sigue siendo la capa de inteligencia; este servidor es solo un puente hacia 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)

Características

Related MCP server: Anki MCP Server

Configuración

1. Instalar Anki Desktop

Descárgalo e instálalo desde https://apps.ankiweb.net/. Ábrelo una vez y sincroniza con tu cuenta de AnkiWeb para que la sincronización móvil funcione.

2. Instalar el complemento AnkiConnect

AnkiConnect expone Anki a través de una API HTTP local en localhost:8765.

Opción A — Navegador de complementos de Anki (la más fácil):

1. En Anki: Herramientas → Complementos → Obtener complementos…

2. Introduce el código 2055492159 e instala.

Opción B — manual (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. Reinicia Anki. Verifica que esté funcionando:

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

3. Ejecutar el servidor MCP

pip install mcp
python server.py

El servidor habla MCP sobre stdio. Anki Desktop debe estar ejecutándose (con AnkiConnect cargado) para que las herramientas funcionen.

Configurar en un cliente

Hermes Agent

Añade a ~/.hermes/config.yaml (o %USERPROFILE%\AppData\Local\hermes\config.yaml en Windows):

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

Luego recarga MCP en la sesión (/reload-mcp) o reinicia. Las herramientas aparecen como mcp_anki_*.

Claude Code

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

Uso

Una vez conectado, solo dile a la IA lo que quieres:

"Añade una tarjeta a mi mazo System Design: frente = '¿Por qué el hashing consistente usa nodos virtuales?', reverso = 'Para distribuir las claves de manera más uniforme.'"

"Crea tarjetas Anki a partir de los conceptos importantes que acabamos de discutir."

Reglas de generación de tarjetas (ponlas en tus instrucciones de IA)

• Un concepto por tarjeta.

• Prefiere preguntas que requieran recordar.

• Evita respuestas enormes.

• No crees tarjetas para hechos triviales.

• Usa tarjetas de cloze cuando sea apropiado.

• Añade etiquetas de fuente/tema.

Sincronizar con el móvil

Las tarjetas creadas por MCP viven en Anki Desktop hasta que sincronices. Activa una sincronización:

• Manualmente: Anki → Sincronizar (o presiona Y), o

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

Luego sincroniza la aplicación móvil de Anki para descargar las nuevas tarjetas.

Requisitos

• Python 3.10+

• Paquete mcp (pip install mcp)

• Anki Desktop (en ejecución)

• Complemento AnkiConnect

Licencia

MIT