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

{
  "name": "createDeck",
  "arguments": {
    "name": "My New Deck"
  }
}

Agregar una nota

{
  "name": "addNote",
  "arguments": {
    "deckName": "My New Deck",
    "modelName": "Basic",
    "fields": {
      "Front": "What is the capital of France?",
      "Back": "Paris"
    },
    "tags": ["geography", "europe"]
  }
}

Notas de búsqueda

{
  "name": "searchNotes",
  "arguments": {
    "query": "deck:\"My New Deck\" tag:geography"
  }
}

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