Anki MCP Server

anki-mcp

Servidor MCP para Anki. Este servidor permite la interacción con Anki mediante el Protocolo de Contexto de Modelo (MCP). Permite a los usuarios gestionar tarjetas, mazos y procesos de revisión mediante programación.

Prerrequisitos

• Node.js y npm instalados.
• Complemento AnkiConnect instalado y ejecutándose en Anki.

Configuración y ejecución

Se recomienda encarecidamente ejecutarlo localmente, ya que Anki Connect solo funciona localmente.

Para ejecutar localmente:

1. Clonar el repositorio:
   git clone https://github.com/nietus/anki-mcp
2. Instalar dependencias:
   npm install
3. Compilar el proyecto: El script prepare en package.json debería ejecutar la compilación automáticamente tras la instalación. Si necesita compilar manualmente:
   npm run build
   Este comando compila el código TypeScript y hace que el script del cliente sea ejecutable.
4. Integrar con la configuración del cursor para Windows
   "anki": { "command": "cmd", "args": [ "/c", "node", "c:/Users/-/Downloads/anki-mcp/build/client.js" ] }

Herramientas disponibles

Para depurar las herramientas, utilice

El servidor proporciona las siguientes herramientas para interactuar con Anki:

• update_cards :
  • Descripción: Después de que el usuario responda las tarjetas en las que lo has interrogado, utiliza esta herramienta para marcarlas como respondidas y actualizar su facilidad.
  • Entrada: una matriz de respuestas, cada una con cardId (número) y ease (número, 1-4).
• add_card :
  • Descripción: Crea una nueva flashcard en Anki. Nota: El contenido usa HTML.
    • Saltos de línea: <br>
    • Código: <pre style="background-color: transparent; padding: 10px; border-radius: 5px;">
    • Listas: <ol> y <li>
    • Negrita: <strong>
    • Cursiva: <em>
  • Aporte:
    • fields : (objeto) Un objeto donde las claves son los nombres de campo (por ejemplo, "Hanzi", "Pinyin") y los valores son su contenido HTML.
    • modelName : (cadena) El nombre del tipo de nota Anki (modelo) a utilizar.
    • deckName : (cadena opcional) El nombre del mazo al que se añadirá la carta. El valor predeterminado es el mazo actual o "Predeterminado".
    • tags : (matriz opcional de cadenas) Una lista de etiquetas para agregar a la nota.
• get_due_cards :
  • Descripción: Devuelve una cantidad determinada de tarjetas que deben revisarse.
  • Entrada: num (número).
• get_new_cards :
  • Descripción: Devuelve una cantidad determinada de tarjetas nuevas y no vistas.
  • Entrada: num (número).
• get-deck-names :
  • Descripción: Obtenga una lista de todos los nombres de mazos de Anki.
  • Entrada: Ninguna.
• find-cards :
  • Descripción: Encuentra tarjetas mediante una consulta de búsqueda Anki sin procesar. Devuelve información detallada de la tarjeta, incluidos los campos.
  • Entrada: query (cadena, p. ej., 'deck:Default -tag:test' o '"deck:My Deck" tag:important' ). Para filtrar campos vacíos, utilice '-FieldName:_*' (p. ej., '-Hanzi:_*' ).
• update-note-fields :
  • Descripción: Actualizar campos específicos de una nota Anki determinada.
  • Entrada: noteId (número), fields (objeto, p. ej., {"Front": "New Q", "Back": "New A"} ).
• create_deck :
  • Descripción: Crea un nuevo mazo de Anki.
  • Entrada: deckName (cadena).
• bulk_update_notes :
  • Descripción: Actualizar campos específicos para múltiples notas de Anki.
  • Entrada: una matriz de notes , donde cada nota tiene noteId (número) y fields (objeto).
• get_model_names :
  • Descripción: Enumera todos los nombres de tipos y modelos de notas Anki disponibles.
  • Entrada: Ninguna.
• get_model_details :
  • Descripción: Recupera los campos, las plantillas de tarjetas y el estilo CSS para un tipo de nota específico.
  • Entrada: modelName (cadena).
• get_deck_model_info :
  • Descripción: Recupera información sobre los tipos de notas (modelos) utilizados en un mazo específico. Ayuda a determinar si se utiliza un solo modelo, varios, o si el mazo está vacío o no existe.
  • Entrada: deckName (cadena).
  • Salida: Un objeto con deckName , status (por ejemplo, "single_model_found", "multiple_models_found", "no_notes_found", "deck_not_found") y, condicionalmente, modelName (cadena) o modelNames (matriz de cadenas).
• add_note_type_field :
  • Descripción: Agrega un nuevo campo a un tipo de nota.
  • Entrada: modelName (cadena), fieldName (cadena).
• remove_note_type_field :
  • Descripción: Elimina un campo existente de un tipo de nota.
  • Entrada: modelName (cadena), fieldName (cadena).
• rename_note_type_field :
  • Descripción: Cambia el nombre de un campo en un tipo de nota.
  • Entrada: modelName (cadena), oldFieldName (cadena), newFieldName (cadena).
• reposition_note_type_field :
  • Descripción: Cambia el orden (índice) de un campo en un tipo de nota.
  • Entrada: modelName (cadena), fieldName (cadena), index (número).
• update_note_type_templates :
  • Descripción: Actualiza las plantillas HTML (por ejemplo, anverso y reverso) para las tarjetas de un tipo de nota.
  • Entrada: modelName (cadena), templates (objeto, p. ej., {"Card 1": {"Front": "html", "Back": "html"}} ).
• update_note_type_styling :
  • Descripción: Actualiza el estilo CSS para un tipo de nota.
  • Entrada: modelName (cadena), css (cadena).
• create_model :
  • Descripción: Crea un nuevo tipo de nota Anki (modelo).
  • Entrada: modelName (cadena), fieldNames (matriz de cadenas), cardTemplates (matriz de objetos, cada uno con las cadenas HTML Name , Front , Back ), css (cadena opcional), isCloze (booleano opcional, el valor predeterminado es falso), modelType (cadena opcional, el valor predeterminado es 'Estándar').
• add_bulk :
  • Descripción: Agrega varias tarjetas a Anki en una sola operación. El contenido de las notas usa HTML. Esta herramienta permite agregar varias notas (tarjetas) a la vez.
  • Entrada: una matriz de notes , donde cada objeto de nota tiene:
    • fields : (objeto) Un objeto donde las claves son los nombres de los campos y los valores son su contenido HTML.
    • modelName : (cadena) El nombre del tipo de nota Anki (modelo) que se utilizará para esta nota.
    • deckName : (cadena opcional) El nombre del deck para esta nota. El valor predeterminado es 'Default'.
    • tags : (matriz opcional de cadenas) Una lista de etiquetas para esta nota.

Puede encontrar más información aquí Integración de Anki | Smithery