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

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

Asegúrate de tener Anki instalado con el complemento AnkiConnect
- Instale AnkiConnect yendo a Herramientas > Complementos > Obtener complementos e ingresando el código: 2055492159
Clonar este repositorio:
git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server
Instalar dependencias:
npm install
Construir el proyecto:
npm run build

Uso

Asegúrese de que Anki se esté ejecutando en su computadora con AnkiConnect habilitado
Inicie el servidor MCP:
npm start
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

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 )
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

Anki MCP Server

Integrations