Servidor MCP de Anki

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar con el software de tarjetas de memoria Anki a través de la API AnkiConnect.

Características

• Crea nuevos mazos en Anki

• Agregar notas a los mazos existentes

• Lista de mazos disponibles y modelos de notas

• Buscar notas usando la sintaxis de búsqueda de Anki

• Obtenga información detallada sobre los modelos de notas y sus campos

• Agregar varias notas a la vez de forma masiva

Related MCP server: Anki MCP Server

Prerrequisitos

• Node.js (v14 o posterior)

• Anki con el complemento AnkiConnect instalado

• Un cliente compatible con el Protocolo de Contexto de Modelo (como Claude con soporte para MCP Antrópico)

Instalación

1. Asegúrate de tener Anki instalado con el complemento AnkiConnect

   • Instale AnkiConnect yendo a Herramientas > Complementos > Obtener complementos e ingresando el código: 2055492159

2. Clonar este repositorio:

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

3. Instalar dependencias:

   npm install

4. Construir el proyecto:

   npm run build

Uso

1. Asegúrese de que Anki se esté ejecutando en su computadora con AnkiConnect habilitado

2. Inicie el servidor MCP:

   npm start

3. Conecte su cliente MCP (por ejemplo, Claude) a este servidor

Herramientas disponibles

El servidor proporciona las siguientes herramientas a los clientes MCP:

• listDecks : Obtén una lista de todos los mazos en Anki

• listModels : Obtenga una lista de todos los modelos/tipos de notas en Anki

• createDeck : Crea un nuevo mazo en Anki

• getModel : obtiene detalles sobre un modelo/tipo de nota específico

• addNote : Agrega una sola nota a un deck

• addNotes : agrega varias notas a la vez

• searchNotes : busca notas usando la sintaxis de búsqueda de Anki

Ejemplos

Crear un nuevo mazo

Agregar una nota

Notas de búsqueda

Configuración

La configuración del servidor se encuentra en el objeto config en src/index.ts . Puede modificarla:

• ankiConnectUrl : URL para la API de AnkiConnect (predeterminado: http://localhost:8765 )

• apiVersion : versión de API para AnkiConnect (predeterminada: 6 )

• defaultDeckName : mazo predeterminado a utilizar si no se especifica ninguno (valor predeterminado: Default )

Solución de problemas

1. No se puede conectar a Anki

   • Asegúrese de que Anki se esté ejecutando

   • Compruebe que el complemento AnkiConnect esté instalado y funcionando

   • Verifique que la URL de AnkiConnect sea correcta (predeterminada: http://localhost:8765 )

2. Problemas de permisos con AnkiConnect

   • AnkiConnect podría solicitar permiso cuando el servidor intenta agregar tarjetas. Busca una ventana emergente en Anki.

Licencia

Licencia MIT