Anki MCP Server

Servidor MCP de Anki

Una implementación de servidor MCP que se conecta a una instancia local de Anki, proporcionando revisión y creación de tarjetas.

Este servidor está diseñado para funcionar con la aplicación de escritorio Anki y el complemento Anki-Connect.

Asegúrate de tener el complemento instalado antes de usarlo.

Recursos

• anki://search/deckcurrent
  • Devuelve todas las tarjetas del mazo actual
  • Equivalente a deck:current en Anki
• anki://search/isdue
  • Devuelve tarjetas en revisión y aprendizaje pendientes de estudiar
  • Equivalente a is:due en Anki
• anki://search/isnew
  • Devuelve todas las tarjetas no vistas
  • Equivalente a is:new en Anki

Herramientas

• update_cards

  • Marca las tarjetas con los IDs dados como respondidas y les asigna una puntuación de facilidad entre 1 (Otra vez) y 4 (Fácil)
  • Entradas:
    • answers (array): Array de objetos con campos cardId (número) y ease (número)

• add_card

  • Crea una nueva tarjeta en el mazo predeterminado de Anki
  • Entradas:
    • front (cadena): Frente de la tarjeta
    • back (cadena): Reverso de la tarjeta

• get_due_cards

  • Devuelve n cantidad de tarjetas actualmente pendientes de revisión
  • Entradas:
    • num (número): Número de tarjetas

• get_new_cards

  • Devuelve n cantidad de tarjetas nuevas
  • Entradas:
    • num (número): Número de tarjetas

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Configuración

Para usar con Claude Desktop, agrega la configuración del servidor:

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

{
  "mcpServers": {
    "anki-mcp-server": {
      "command": "/path/to/anki-mcp-server/build/index.js"
    }
  }
}

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.