servidor anki-mcp

Lea esto en otros idiomas:

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a Claude y Anki, permitiéndote crear fácilmente tarjetas didácticas usando lenguaje natural.

Introducción

anki-mcp-server actúa como puente entre Claude y la app de Anki, facilitando la comunicación entre ellos. Esto permite dar comandos en lenguaje natural a Claude para crear y gestionar tarjetas de vocabulario de Anki. Por ejemplo, si pides "Añadir una tarjeta de vocabulario japonés fácil a mi mazo de japonés", Claude creará automáticamente la tarjeta adecuada.

Related MCP server: Anki MCP Server

Requisitos

• Python 3.8 o superior

• Anki 2.1.x o superior

• Complemento AnkiConnect

• Claude Desktop (o un entorno con acceso a la API de Claude)

Instalación

1. Configuración de Anki y AnkiConnect

1. Instalar Anki .

2. Instalar el complemento AnkiConnect:

   • Ejecute Anki y seleccione Tools > Add-ons > Get Add-ons en el menú superior

   • Introduce el código 2055492159 y haz clic en «Aceptar»

   • Reiniciar Anki

2. Instalación de anki-mcp-server

Configuración

Configuración del escritorio de Claude

Modifique el archivo de configuración de Claude Desktop para registrar el servidor MCP:

1. Ubicación del archivo de configuración de Claude Desktop:

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Agregue el siguiente contenido al archivo de configuración:

Reemplace path/anki_server.py con la ruta absoluta a su archivo anki_server.py.

Cómo utilizar

1. Ejecute la aplicación Anki y manténgala ejecutándose en segundo plano.

2. Inicie Claude Desktop.

3. Puedes darle a Claude comandos en lenguaje natural como:

Comandos de ejemplo

• "Añadir una tarjeta de vocabulario japonés fácil a mi baraja de japonés"

• Crea una tarjeta para la palabra inglesa "perseverancia" con su significado y ejemplos.

• "Resume en una tarjeta los conceptos de programación que aprendí hoy"

• Crea 5 tarjetas de cronología histórica.

Claude interpretará estas solicitudes y creará tarjetas apropiadas en Anki a través del servidor MCP.

Características principales

Funciones de creación de tarjetas

• Creación de tarjetas con formato básico de preguntas y respuestas

• Creación de tarjetas de aprendizaje de idiomas (palabra, significado, oraciones de ejemplo)

• Adición automática de etiquetas

• Agregar cartas a varios mazos

Funciones de gestión de cubiertas

• Ver lista de mazos disponibles

• Crear nuevos mazos

• Buscar cartas en mazos específicos

Solución de problemas

Problemas de conexión

• Compruebe si Anki se está ejecutando : el servidor MCP requiere que Anki se esté ejecutando para comunicarse con él.

• Verificar AnkiConnect : Asegúrese de que AnkiConnect esté correctamente instalado. Visite http://localhost:8765 en su navegador web para confirmar que ve el mensaje "AnkiConnect v.6".

• Configuración del firewall : es posible que los usuarios de Windows necesiten permitir el acceso del firewall a Anki.

Problemas con el servidor MCP

• Comprobar registros : si ocurren problemas, verifique los registros del servidor para ver si hay mensajes de error.

• Reiniciar : si los problemas persisten, intente reiniciar Anki, Claude Desktop y el servidor MCP.

Extensión y Contribución

Si deseas contribuir al proyecto, bifurca el repositorio de GitHub y envía una solicitud de incorporación de cambios. Agradecemos contribuciones en las siguientes áreas:

• Compatibilidad con nuevos tipos de tarjetas

• Soporte de idiomas mejorado

• Mejoras de la interfaz

• Mejoras en la documentación

Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulte el archivo de licencia para más detalles.

Contacto

Si tiene problemas o preguntas, comuníquese con nosotros a través de los problemas de GitHub.