Servidor MCP de Anki

Un servidor del 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 múltiples notas a la vez

• search_notes - Busca notas usando la sintaxis de consulta de Anki

• get_note_info - Obtiene información detallada sobre una nota

• update_note - Actualiza una nota existente

• delete_note - Elimina una nota

• list_note_types - Lista todos los tipos de nota disponibles

• create_note_type - Crea un nuevo tipo de nota

• get_note_type_info - Obtiene 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 nota disponibles

• anki://note-types/all-with-schemas - Información detallada de la estructura para todos los tipos de nota

• anki://note-types/{modelName} - Información detallada de la estructura para un tipo de nota específico

Related MCP server: Anki MCP Server

Requisitos previos

1. Anki instalado en tu sistema

2. Complemento AnkiConnect instalado en Anki

Configuración

Instalación mediante extensión de escritorio (.mcpb)

Este repositorio es compatible con las extensiones de escritorio de Anthropic (MCPB). La forma más fácil de usar este servidor en Claude Desktop es instalando el paquete .mcpb empaquetado.

1. Genera el archivo .mcpb localmente usando el script proporcionado:

npm run pack

2. Abre la Configuración de Claude Desktop → Extensiones y arrastra el archivo .mcpb generado, luego haz clic en Instalar.

Esto valida manifest.json y genera un archivo .mcpb que puedes instalar como se indicó anteriormente. Aprende más sobre las extensiones de escritorio en el anuncio de Anthropic: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Uso con Claude Desktop

Añade el servidor a tu claude_desktop_config.json:

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

Uso de un puerto personalizado de AnkiConnect

Si tu AnkiConnect se está ejecutando en un puerto diferente, puedes especificarlo usando el parámetro --port:

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

Configuración para Cline

Añade el servidor a tu archivo de configuración MCP de Cline dentro de la configuración de VSCode cline_mcp_settings.json

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

Uso de un puerto personalizado de AnkiConnect

Para Cline, también puedes especificar un puerto personalizado:

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

Habilidades de agente (Claude Code)

Instala la habilidad de Anki para darle a Claude Code conocimiento integrado de todas las herramientas y flujos de trabajo de Anki:

npx skills add nailuoGG/anki-mcp-server@anki

Una vez instalada, Claude Code utilizará automáticamente la habilidad cuando le pidas crear tarjetas, gestionar mazos o importar notas por lotes.

Nota: No utilices la versión empaquetada .mcpb como servidor MCP; esta envía metadatos de Electron a stdout, lo que rompe el protocolo stdio de MCP. Utiliza npx -y anki-mcp-server en su lugar.

Desarrollo

Empaquetado de una extensión de escritorio (.mcpb)

Crea un paquete de extensión de escritorio distribuible para Claude Desktop:

npm run pack

Esto compilará el proyecto y generará un archivo .mcpb desde el repositorio actual, validando manifest.json. Pruébalo arrastrándolo a la configuración de Extensiones de Claude Desktop. Referencia: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Publicación en el registro MCP

Este servidor se publica automáticamente en el registro MCP cuando se lanza una nueva versión. El proceso de publicación incluye:

1. CI/CD automatizado: GitHub Actions publica automáticamente tanto en NPM como en el registro MCP tras lanzamientos exitosos

2. Validación de esquema: El archivo server.json se valida contra el esquema MCP antes de la publicación

3. Sincronización de versiones: Las versiones se mantienen sincronizadas entre package.json, manifest.json y server.json

4. Pruebas exhaustivas: Pruebas de Node.js en múltiples versiones, linting y validación antes de la publicación

5. Soporte beta: Lanzamientos beta automatizados para probar nuevas funciones

Validación manual

Puedes validar la configuración del servidor MCP localmente:

npm run validate-mcp

Esto descargará el último esquema MCP y validará tu archivo server.json.

Publicación manual

Si necesitas publicar manualmente, puedes usar la CLI de MCP Publisher:

# Install MCP Publisher
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
chmod +x mcp-publisher
sudo mv mcp-publisher /usr/local/bin/

# Login to MCP Registry
mcp-publisher login github-oidc

# Publish to MCP Registry
mcp-publisher publish

Configuración

1. Instala las dependencias:

npm install

2. Compila el servidor:

npm run build

3. Para desarrollo con recompilación automática:

npm run watch

Pruebas

Ejecuta la suite de pruebas:

npm test

Esto ejecuta pruebas para:

• Inicialización del servidor

• Comunicación con AnkiConnect

• Operaciones de notas (crear/leer/actualizar/eliminar)

• Gestión de mazos

• Manejo de errores

Depuración

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

npm run inspector

Esto proporciona una interfaz basada en navegador para:

• Monitorear mensajes MCP

• Probar invocaciones de herramientas

• Ver registros del servidor

• Depurar problemas de comunicación

Ejemplo de uso

1. Crea un nuevo mazo:

Create a new Anki deck called "Programming"

2. Añade 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.

3. Añade una tarjeta de tipo cloze:

Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

Contribución

1. Haz un fork del repositorio

2. Crea tu rama de funciones

3. Ejecuta las pruebas: npm test

4. Envía una solicitud de extracción (pull request)

Historial de estrellas

Créditos

Icono cortesía de macOS Icons

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles