🧠 Anki MCP

¡Transforma tu experiencia con las tarjetas de estudio de Anki con IA! Este servidor MCP (Protocolo de Contexto de Modelo) conecta tu colección de tarjetas de estudio de Anki con asistentes de IA como Claude, lo que permite conversaciones naturales sobre tus materiales de estudio.

¿Qué puedes hacer?

Imagina tener un tutor de IA que conoce toda tu colección de tarjetas didácticas y puede:

📚 Aprendizaje interactivo

• "Pregúntame sobre el vocabulario japonés que no he visto en tres días"

• "Ponme a prueba con cartas desafiantes de mi mazo médico"

• "Muéstrame las cartas con las que he estado teniendo problemas últimamente"

✨ Creación de contenido inteligente

• Crea tarjetas didácticas sobre la fotosíntesis con diagramas.

• Convierte este capítulo PDF en tarjetas de repetición espaciada.

• Generar tarjetas de eliminación de espacios vacíos a partir de mis apuntes de clase.

🔍 Análisis potente

• "¿Con qué temas tengo más dificultades?"

• "Muéstrame mis patrones de estudio del último mes"

• "¿Cuál es mi tasa de retención para los diferentes tipos de tarjetas?"

🎯 Operaciones masivas

• Etiqueta todas mis tarjetas de química con 'preparación para exámenes'.

• Trasladar las cartas con baja retención a un mazo de revisión intensiva.

• "Buscar y corregir cartas duplicadas en mis mazos"

🎯 Características

• Integración completa con Anki : acceso completo a mazos, cartas, notas y estadísticas a través de los 115 métodos de API de AnkiConnect

• Interfaz conversacional : comandos en lenguaje natural a través de su asistente de IA

• Operaciones masivas : administre de manera eficiente miles de tarjetas a la vez

• Estadísticas en tiempo real : obtenga información sobre su progreso de aprendizaje

• Compatibilidad con medios : administre imágenes, audio y otros medios en sus tarjetas

• Consulta avanzada : busque tarjetas utilizando criterios de búsqueda complejos

• Seguridad de tipos : API totalmente tipificada con manejo integral de errores

🛠 Pila técnica

• Node.js : entorno de ejecución (se requiere mayor de 18 años)

• TypeScript : seguridad de tipos y experiencia del desarrollador

• SDK de MCP : Implementación del protocolo de contexto de modelo

• yanki-connect : 🙏 Cliente API AnkiConnect totalmente tipificado e isomórfico

• tsup : Empaquetador rápido de TypeScript

• PNPM : Gestor de paquetes eficiente

¡Un agradecimiento especial a la biblioteca

📋 Requisitos previos

1. Instalar Anki

Descargue e instale Anki si aún no lo ha hecho.

2. Instalar el complemento AnkiConnect

1. Abrir Anki

2. Vaya a Herramientas → Complementos

3. Haga clic en Obtener complementos...

4. Introduzca el código: 2055492159

5. Reiniciar Anki

Requisitos de la versión: Este servidor requiere la versión 25.2.25.0 o posterior de AnkiConnect (publicada el 25/02/2025) para una compatibilidad total. La mayoría de las funciones funcionan con versiones anteriores, pero recomendamos actualizar para disfrutar de la mejor experiencia.

3. Configurar AnkiConnect (opcional)

AnkiConnect funciona de inmediato, pero puedes personalizar la configuración:

1. Vaya a Herramientas → Complementos

2. Seleccione AnkiConnect y haga clic en Configurar

3. La configuración predeterminada debería funcionar bien para la mayoría de los usuarios.

🚀 Inicio rápido

Opción 1: Usar con Claude Desktop (recomendado)

1. Instalar el paquete

   npm install -g @arielbk/anki-mcp

2. Configurar Claude Desktop

   Edite su archivo de configuración de Claude Desktop:

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

   Añade esta configuración:

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

3. Reiniciar Claude Desktop

4. ¡Empieza a usarlo!

   • Asegúrese de que Anki se esté ejecutando con AnkiConnect habilitado

   • Pregúntale a Claude: "Muéstrame mis mazos de Anki" o "Ponme a prueba con 5 cartas".

💡 Consejo profesional: puedes probar tu configuración haciéndole a Claude preguntas simples como "¿Cuántos mazos de Anki tengo?" o "¿Qué hay en mi mazo más grande?"

Opción 2: Configuración del desarrollo

1. Clonar el repositorio

   git clone https://github.com/arielbk/anki-mcp.git cd anki-mcp

2. Instalar dependencias

   pnpm install

3. Construir el proyecto

   pnpm build

4. Probar el servidor

   # Use the MCP inspector to test functionality pnpm inspect

Opción 3: Uso con otros clientes MCP

Este servidor funciona con cualquier cliente compatible con MCP. También puede usarlo con:

• MCP Inspector : herramienta de depuración interactiva

• Cline : extensión de VS Code para codificación de IA

• Clientes MCP personalizados : cree el suyo propio utilizando el SDK de MCP

Para el transporte stdio, ejecute:

Ejemplos de uso

Una vez configurado con Claude Desktop, podrás tener conversaciones naturales como:

📖 Sesiones de estudio

📝 Creación de contenido

📊 Análisis del estudio

🏷️ Organización

🔧 Herramientas y recursos disponibles

Este servidor MCP proporciona acceso integral a su colección Anki a través de estas capacidades:

📚 Gestión de cubiertas

• Listado de todos los mazos con estadísticas

• Crear nuevos mazos

• Cambiar el nombre y eliminar mazos

• Obtener la configuración del deck

Operaciones con tarjeta

• Buscar tarjetas por criterios de búsqueda

• Tarjetas de respuestas (simulan revisiones)

• Obtener información y estadísticas de la tarjeta

• Suspender/reactivar tarjetas

• Operaciones con tarjetas en masa

📝 Gestión de notas

• Agregar nuevas notas con campos personalizados

• Actualizar notas existentes

• Eliminar notas

• Buscar notas mediante consulta de búsqueda

• Operaciones de notas masivas

📊 Estadísticas y análisis

• Estadísticas de mazo y métricas de rendimiento

• Datos de intervalo y facilidad de uso de la tarjeta

• Revisar el historial y los patrones

• Perspectivas sobre el progreso del aprendizaje

🎨 Medios y modelos

• Tipos de notas de acceso y definiciones de campos

• Gestión de archivos multimedia

• Soporte de personalización de plantillas

🔍 Funciones avanzadas

• Consultas de búsqueda complejas utilizando la sintaxis de búsqueda de Anki

• Operaciones por lotes para mayor eficiencia

• Sincronización en tiempo real con Anki

• Manejo de errores y validación

• Métodos API organizados agrupados por funcionalidad (cartas, mazos, notas, modelos, estadísticas, medios, etc.)

• Acceso directo a los 115 métodos API de AnkiConnect con seguridad de tipo completa

🛠 Desarrollo

🔧 Configuración

Configuración de AnkiConnect

El servidor se conecta a AnkiConnect en localhost:8765 por defecto. Si has personalizado la configuración de AnkiConnect, es posible que tengas que ajustar la configuración de conexión.

Importante : Asegúrese de que Anki esté en ejecución y que AnkiConnect esté instalado antes de usar el servidor MCP. El servidor no podrá conectarse si AnkiConnect no está disponible.

💡 Nota: La biblioteca subyacente yanki-connect admite el inicio automático de Anki en macOS, pero esta función no está disponible actualmente en la configuración del servidor MCP. Deberá iniciar Anki manualmente.

Configuración avanzada de Claude Desktop

Para usuarios avanzados, puedes pasar parámetros adicionales:

Solución de problemas

Problemas comunes:

• "Error al conectar con AnkiConnect" : Asegúrese de que Anki se esté ejecutando y que el complemento AnkiConnect esté instalado.

• "No se encontraron mazos" : Asegúrate de tener al menos un mazo en Anki

• Claude no responde : Reiniciar Claude Desktop después de los cambios de configuración

• Errores de permisos : Verifique que la instalación global de npm funcionó correctamente con npm list -g @arielbk/anki-mcp

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Por favor:

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Agregue pruebas si corresponde

5. Enviar una solicitud de extracción

📜 Licencia

MIT - consulte el archivo LICENCIA para obtener más detalles.

🙏 Agradecimientos

• yanki-connect - Excelente cliente TypeScript para AnkiConnect

• AnkiConnect : el complemento que hace posible la automatización de Anki

• Protocolo de contexto de modelo : facilitación de integraciones fluidas de IA

¡Transforma tu experiencia con tarjetas didácticas con conversaciones impulsadas por IA! 🚀