servidor anki-mcp

Lea esto en otros idiomas: inglés , coreano

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.

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

Instalar Anki .
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

# Clone the repository
git clone https://github.com/dhkim0124/anki-mcp-server.git
cd anki-mcp-server

# Create and activate a virtual environment (optional)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install required packages
pip install -r requirements.txt

Configuración

Configuración del escritorio de Claude

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

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
Agregue el siguiente contenido al archivo de configuración:

{
  "mcpServers": {
    "anki-mcp": {
      "command": "python",
      "args": ["path/anki_server.py"],
      "env": {}
    }
  }
}

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

Cómo utilizar

Ejecute la aplicación Anki y manténgala ejecutándose en segundo plano.
Inicie Claude Desktop.
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.

Anki MCP Server

Integrations