Servidor MCP mcp-ankiconnect

Conecte las conversaciones de Claude con AnkiConnect a través de MCP para que la repetición espaciada sea tan fácil como "Repasemos las tarjetas de hoy" o "Crea tarjetas para esto".

Componentes

Herramientas

El servidor implementa tres herramientas:

• num_cards_due_today : Obtener el número de tarjetas que vencen hoy

  • Argumento deck opcional para filtrar por mazo específico

  • Devuelve el recuento de cartas pendientes en todos los mazos o en el mazo especificado

• get_due_cards : Obtener tarjetas que deben revisarse

  • Argumento limit opcional (predeterminado: 5) para controlar el número de tarjetas

  • Argumento deck opcional para filtrar por mazo específico

  • Argumento opcional today_only (valor predeterminado: verdadero) para mostrar solo las tarjetas de hoy

  • Devuelve tarjetas en formato XML con preguntas y respuestas.

• submit_reviews : Enviar respuestas para tarjetas revisadas

  • Toma una lista de reviews con card_id y rating

  • Calificaciones: "incorrecto", "difícil", "bueno", "fácil"

  • Devuelve la confirmación de las reseñas enviadas

Related MCP server: Anki MCP Server

Configuración

Prerrequisitos

• Anki debe tener instalado el plugin AnkiConnect (id de plugin 2055492159). AnkiConnect puede ser lento en Mac debido a la función AppSleep, así que desactívela. Para ello, ejecute lo siguiente en su terminal.

  defaults write net.ankiweb.dtop NSAppSleepDisabled -bool true
  defaults write net.ichi2.anki NSAppSleepDisabled -bool true
  defaults write org.qt-project.Qt.QtWebEngineCore NSAppSleepDisabled -bool true

Instalación

Inicio rápido

1. Instalar el complemento AnkiConnect en Anki:

   • Herramientas > Complementos > Obtener complementos...

   • Introduzca el código: 2055492159

   • Reiniciar Anki

2. Configurar Claude Desktop:

   En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

   Añade esta configuración:

   {
     "mcpServers": {
       "mcp-ankiconnect": {
         "command": "uv",
         "args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
       }
     }
   }

3. Reiniciar Anki y el escritorio de Claude

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP . Primero, clone el repositorio e instale las dependencias:

git clone https://github.com/samefarrar/mcp-ankiconnect.git
cd mcp-ankiconnect
uv sync

Puede iniciar el Inspector MCP a través de la CLI de mcp:

uv run mcp dev mcp_ankiconnect/server.py

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.