Servidor MCP de Anki

Un servidor MCP (Protocolo de contexto de modelo) para Claude Desktop que se conecta a Anki a través de AnkiConnect y recupera tarjetas etiquetadas con leech.

Características

• Se conecta a Anki a través de la API AnkiConnect
• Recupera tarjetas con etiquetas "leech"
• Agrega etiquetas de revisión con fecha estampada a las tarjetas
• Proporciona datos completos de tarjetas para que Claude los analice.
• Se puede utilizar con Claude Desktop

Prerrequisitos

• Anki instalado y funcionando
• Complemento AnkiConnect instalado en Anki
• Node.js y npm

Instalación

1. Clonar este repositorio:
   git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build

Configuración

El servidor se puede configurar mediante variables de entorno. Copie el archivo de ejemplo proporcionado para crear su propia configuración:

Luego edite el archivo .env para personalizar su configuración:

Si no se configuran las variables de entorno, el servidor utilizará los valores predeterminados.

Cómo encontrar su dirección IP local para AnkiConnect

Si no puede conectarse al localhost , deberá usar la dirección IP local de su computadora. Configure su archivo .env con:

Para encontrar su dirección IP local:

• macOS : Abra la Terminal y ejecute ifconfig o ipconfig getifaddr en0 (para WiFi)
• Windows : Abra el símbolo del sistema y ejecute ipconfig
• Linux : Abra la terminal y ejecute ip addr show o hostname -I

Busque direcciones IPv4 como 192.168.xx o 10.xxx en la salida.

Configuración de prueba

Para realizar pruebas, se proporciona un archivo de configuración separado .env.test :

Edite .env.test para establecer valores específicos de la prueba:

Para ejecutar en modo de prueba:

Uso

1. Asegúrese de que Anki se esté ejecutando con AnkiConnect instalado
2. Ejecute el servidor MCP:
   npm start

Configuración de Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

1. Abra Claude Desktop
2. Edite el archivo de configuración de Claude Desktop ubicado en:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
3. Agregue la siguiente configuración a la sección mcpServers :

Reemplace "path/to/anki-mcp-server" con la ruta real a donde clonó este repositorio.

Uso de la herramienta MCP

Una vez configurado, podrás utilizar las siguientes herramientas en Claude:

Ejemplo de uso

Claude utilizará el servidor MCP para recuperar tus tarjetas sanguijuelas y analizarlas.

Herramientas disponibles

obtener_tarjetas_sanguijuela

Recupera tarjetas etiquetadas como sanguijuelas de Anki.

Parámetros:

• detailed (opcional, booleano, predeterminado: verdadero): si se deben devolver datos completos de la tarjeta o solo identificaciones
• count (opcional, número): Número de cartas aleatorias a devolver (predeterminado: todas las cartas)

tarjetas revisadas por etiqueta

Añade una etiqueta de "revisado" con fecha a tarjetas específicas. Esto te permite rastrear qué tarjetas has revisado con Claude.

Parámetros:

• card_ids (obligatorio, matriz de números): Matriz de identificaciones de tarjetas para etiquetar como revisadas
• custom_tag_prefix (opcional, cadena, predeterminado: "見直し"): prefijo personalizado para la etiqueta

La etiqueta tendrá el formato見直し_YYYYMMDD (o su prefijo personalizado si se especifica).

Ejemplo de uso en Claude:

Solución de problemas

• "No se pudo conectar a Anki" : asegúrese de que Anki se esté ejecutando y que AnkiConnect esté instalado correctamente.
• "No se encontraron tarjetas sanguijuelas" : No tienes ninguna tarjeta etiquetada como "sanguijuela" en Anki.
• Problemas de conexión con localhost : si no puede conectarse usando localhost :
  1. Encuentre su dirección IP local como se describe en la sección Configuración
  2. Actualice su archivo .env para usar ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765
  3. Asegúrese de que AnkiConnect esté configurado para permitir conexiones desde su dirección IP
  4. Reinicie el servidor MCP después de realizar estos cambios
• La etiqueta no aparece : asegúrese de proporcionar identificaciones de tarjetas válidas a la herramienta tag_reviewed_cards

Modo de prueba

Para realizar pruebas sin afectar los datos reales de Anki, puedes usar el modo simulado:

1. Establezca ANKI_MOCK_MODE=true en su archivo .env o utilice el archivo .env.test proporcionado
2. Ejecute el servidor con npm run start:test

En el modo simulado, el servidor simulará todas las operaciones de Anki sin conectarse a él. Esto resulta útil para probar las integraciones de Claude sin arriesgarse a modificar los datos.

Desarrollo

Para ejecutar el servidor en modo de desarrollo con recarga en caliente:

Para el desarrollo con el modo simulado habilitado:

Licencia

Instituto Tecnológico de Massachusetts (MIT)