Anki MCP Server

Servidor MCP de Anki

Un servidor de Protocolo de Contexto de Modelo (MCP) para integrar asistentes de IA con Anki, el popular software de tarjetas de memoria con repetición espaciada.

Características

Este servidor MCP permite a los asistentes de IA interactuar con Anki a través de las siguientes herramientas:

Herramientas

• get-collection-overview: Devuelve una descripción general de la colección de Anki, como los mazos disponibles, los modelos disponibles y sus campos.

• add-or-update-notes: Agrega notas nuevas o actualiza las existentes. Permite agregar/actualizar múltiples notas a la vez.

• get-cards-reviewed: Obtiene el número de tarjetas revisadas por día.

• find-notes: Permite consultar notas utilizando la sintaxis de búsqueda de Anki.

• find-cards: Encuentra IDs de tarjetas que coincidan con una consulta en Anki.

• suspend-cards: Suspende tarjetas por sus IDs de tarjeta.

• unsuspend-cards: Reactiva tarjetas por sus IDs de tarjeta.

Recursos

• anki://docs/search-syntax: Guía de referencia completa para la sintaxis de consultas de búsqueda de Anki. Incluye operadores básicos, búsquedas por campo, etiquetas, mazos, estados de tarjetas, propiedades, tiempos, IDs, datos personalizados y ejemplos de consultas avanzadas. Este recurso proporciona documentación independiente del idioma, útil para cualquiera que construya consultas de búsqueda con las herramientas find-notes o find-cards.

Requisitos

• Anki debe estar instalado y en ejecución.
• El complemento AnkiConnect debe estar instalado en Anki y en ejecución.
• Este servidor MCP utiliza uv. Para instalar uv, sigue las instrucciones oficiales.

Instalación

Como complemento de Claude Code (recomendado)

Instálalo como complemento para obtener tanto el servidor MCP como la habilidad de aprendizaje de idiomas en un solo paso:

/plugin install anki-mcp

Configuración manual para Claude Code

1. Agrega el servidor MCP:

   claude mcp add anki -- uvx anki-mcp
   

2. Opcionalmente, copia los archivos de habilidad desde skills/ al directorio .claude/skills/ de tu proyecto para obtener orientación sobre el aprendizaje de idiomas.

Claude Desktop

1. Abre tu archivo de configuración de Claude Desktop:

   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Agrega anki-mcp a la sección mcpServers:

   "mcpServers": {
     "anki": {
       "command": "uvx",
       "args": ["anki-mcp"]
     }
   }
   

3. Reinicia Claude Desktop.

Solo servidor MCP

Para otros clientes compatibles con MCP, ejecuta el servidor directamente:

uvx anki-mcp

Habilidad de Aprendizaje de Idiomas

Este complemento incluye una habilidad complementaria que proporciona mejores prácticas para crear tarjetas de memoria efectivas para el aprendizaje de idiomas. Cuando se instala como complemento, la habilidad está disponible automáticamente. La habilidad incluye:

• Flujo de trabajo recomendado para la creación de tarjetas.
• Pautas de calidad de tarjetas (longitud, contenido, uso de cloze).
• Recomendaciones de variedad de tipos de notas.
• Ejemplos de tarjetas buenas vs. malas.
• Pautas de nivel de competencia (MCER A1-C2).

El servidor MCP funciona de manera independiente de la habilidad, por lo que puedes usarlo para cualquier flujo de trabajo de Anki, no solo para el aprendizaje de idiomas.