Anki MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables interaction with Anki flashcard software through AnkiConnect, providing tools for managing decks, creating various types of flashcards (Basic and Cloze), searching notes, and manipulating note types.

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 AnkiConnect.

Características

Herramientas

  • list_decks - Lista todos los mazos de Anki disponibles
  • create_deck - Crea un nuevo mazo de Anki
  • create_note - Crea una nueva nota (Básica o Cloze)
  • batch_create_notes - Crea varias notas a la vez
  • search_notes - Busca notas usando la sintaxis de consulta de Anki
  • get_note_info - Obtener información detallada sobre una nota
  • update_note - Actualizar una nota existente
  • delete_note - Eliminar una nota
  • list_note_types - Lista todos los tipos de notas disponibles
  • create_note_type - Crea un nuevo tipo de nota
  • get_note_type_info - Obtener la estructura detallada de un tipo de nota

Recursos

  • anki://decks/all - Lista completa de mazos disponibles
  • anki://note-types/all - Lista de todos los tipos de notas disponibles
  • anki://note-types/all-with-schemas : información detallada de la estructura para todos los tipos de notas
  • anki://note-types/{modelName} - Información detallada de la estructura para un tipo de nota específico

Prerrequisitos

  1. Anki instalado en su sistema
  2. Complemento AnkiConnect instalado en Anki

Configuración

Uso con Claude Desktop

Agregue el servidor a su claude_desktop_config.json:

{ "mcpServers": { "anki": { "command": "npx", "args": ["--yes","anki-mcp-server"] } } }

Configuración para Cline

Agregue el servidor a su archivo de configuración de Cline MCP dentro de la configuración de VSCode cline_mcp_settings.json

{ "mcpServers": { "anki": { "command": "npx", "args": ["--yes","anki-mcp-server"] } } }

Desarrollo

Configuración

  1. Instalar dependencias:
npm install
  1. Construir el servidor:
npm run build
  1. Para desarrollo con reconstrucción automática:
npm run watch

Pruebas

Ejecute el conjunto de pruebas:

npm test

Esto ejecuta pruebas para:

  • Inicialización del servidor
  • Comunicación AnkiConnect
  • Operaciones de notas (crear/leer/actualizar/eliminar)
  • Gestión de cubiertas
  • Manejo de errores

Depuración

Dado que los servidores MCP se comunican a través de stdio, recomendamos utilizar el Inspector MCP :

npm run inspector

Esto proporciona una interfaz basada en navegador para:

  • Monitoreo de mensajes MCP
  • Invocaciones de herramientas de prueba
  • Visualización de registros del servidor
  • Depuración de problemas de comunicación

Ejemplo de uso

  1. Crear un nuevo mazo:
Create a new Anki deck called "Programming"
  1. Añadir una tarjeta básica:
Create an Anki card in the "Programming" deck with: Front: What is a closure in JavaScript? Back: A closure is the combination of a function and the lexical environment within which that function was declared.
  1. Agregar una tarjeta de eliminación de espacios en blanco:
Create a cloze card in the "Programming" deck with: Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

Contribuyendo

  1. Bifurcar el repositorio
  2. Crea tu rama de funciones
  3. Ejecutar pruebas: npm test
  4. Enviar una solicitud de extracción

Créditos

Icono cortesía de macOS Icons

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo que permite a los LLM interactuar con el software de tarjetas didácticas Anki a través de AnkiConnect, lo que permite la creación y gestión de tarjetas didácticas, mazos y tipos de notas.

  1. Features
    1. Tools
    2. Resources
  2. Prerequisites
    1. Configuration
      1. Usage with Claude Desktop
      2. Configuration for Cline
    2. Development
      1. Setup
      2. Testing
      3. Debugging
    3. Example Usage
      1. Contributing
        1. Credits
          1. License
            ID: fpgag671vh