Skip to main content
Glama

Anki Quiz MCP

Un servidor MCP local para convertir preguntas de lectura y escritura en inglés en cuestionarios interactivos y tarjetas de repaso. En un cuestionario puedes marcar una opción por pregunta, navegar por el lote, entregar, ver tu puntuación y revisar los errores. El ejemplo incluido tiene diez preguntas originales en inglés.

Pruébalo en un navegador

Necesitas Node.js 22 o posterior y npm. Desde la carpeta del repositorio, ejecuta:

npm ci
npm run build
npm run quiz -- examples/sat-reading-writing.json

El último comando imprime la ruta de un archivo HTML. Ábrelo en tu navegador y contesta el cuestionario. El archivo incluye su propio estilo y código. Funciona sin conexión y las respuestas se borran al cerrar o recargar la página. Puedes elegir una carpeta de salida con un segundo argumento o con la variable ANKI_SAT_EXPORT_DIR. La ubicación predeterminada es Anki SAT Exports dentro de tu carpeta de usuario.

Related MCP server: anki-mcp

Usarlo en Anki desde un cliente MCP

  1. Instala Anki Desktop y el complemento de terceros AnkiConnect. En Anki, el código del complemento es 2055492159. Reinicia Anki y deja abierto el perfil que quieres usar.

  2. Registra un servidor MCP con transporte stdio. Usa node como comando y la ruta absoluta de dist/src/index.js como argumento. En Codex puedes registrarlo con este comando desde la carpeta del repositorio:

    codex mcp add anki-sat -- (Get-Command node.exe).Source (Resolve-Path .\dist\src\index.js).Path
  3. Pide al cliente un cuestionario y solicita una vista previa con preview_sat_quiz. Revisa el mazo y el número de preguntas antes de guardar con commit_sat_preview.

  4. Abre el mazo en Anki y pulsa Study Now. En el frente de la tarjeta, responde y pulsa Submit quiz en la última pregunta. Anki coloca la clave en Show Answer. Puedes usar esa clave al terminar y registrar el repaso con los botones habituales de Anki.

El primer guardado interactivo crea el tipo de nota SAT Interactive Quiz v1. Cada formulario ocupa una tarjeta de Anki. La puntuación del cuestionario se calcula en el formulario y la calificación de repaso la decides en Anki. El manual de Anki documenta el uso de JavaScript en las tarjetas y advierte que puede variar entre clientes. Si un cliente no ejecuta el formulario, usa el HTML exportado.

Herramientas MCP

Herramienta

Entrada

Qué hace

preview_sat_quiz

deck, questions

Previsualiza un cuestionario completo para Anki y devuelve un token.

export_sat_quiz

deck, questions

Guarda un cuestionario HTML que se puede contestar en un navegador.

preview_sat_questions

deck, questions

Previsualiza tarjetas individuales y devuelve un token.

commit_sat_preview

previewToken

Guarda una vista previa, crea el mazo si hace falta y omite duplicados.

export_sat_tsv

deck, questions

Guarda tarjetas individuales para importar en Anki con el tipo de nota Basic.

list_decks

—

Lista los mazos del perfil abierto.

check_deck

deck

Comprueba si existe un mazo.

Las vistas previas consultan Anki. La exportación HTML y TSV funciona con Anki cerrado. Los tokens caducan a los diez minutos y se usan una sola vez en el proceso que los emitió.

Formato de preguntas

Usa de una a cincuenta preguntas en cada lote. Proporciona el texto, cuatro opciones, una letra correcta y, si quieres, una explicación. El cliente MCP puede preparar estos datos a partir de preguntas que le proporciones.

{
  "deck": "English Reading and Writing",
  "questions": [
    {
      "stem": "Both researchers submitted ____ reports on time.",
      "choices": { "A": "their", "B": "there", "C": "they’re", "D": "theirs" },
      "answer": "A",
      "explanation": "Their is the possessive determiner that modifies reports."
    }
  ]
}

Privacidad y permisos

  • El servidor habla con AnkiConnect en 127.0.0.1:8765. AnkiConnect puede usar una clave. Suminístrala mediante ANKI_CONNECT_API_KEY o el archivo local %LOCALAPPDATA%\AnkiSatMcp\ankiconnect.key en Windows. Guarda la clave fuera del repositorio.

  • El HTML exportado no carga recursos externos ni envía las respuestas. Incluye la clave de respuestas para corregir localmente. Sirve para práctica personal.

  • Configura tu cliente MCP para pedir confirmación al llamar a commit_sat_preview, la única herramienta que cambia la colección. Si tu cliente usa un modelo en la nube, sus políticas se aplican al contenido que le compartas.

  • Usa preguntas originales o materiales cuyos permisos cubran el uso que les darás. Los ejemplos son originales, creados con asistencia de IA. El proyecto es independiente. Consulta las marcas, derechos de contenido y dependencias y el aviso de privacidad.

npm test compila el proyecto y ejecuta las pruebas locales. Consulta la licencia MIT.

Available Tools

7 tools
check_deckCheck an Anki deckA
Read-onlyIdempotent

Check whether a deck exists. Matching ignores letter case, and the result gives the exact deck name. Read-only.

Inputs: deck (required).

commit_sat_previewSave a previewed SAT quiz or flashcard batch to AnkiA

Save a preview_sat_quiz or preview_sat_questions result. Pass only previewToken. Each token works once, expires after 10 minutes, and is valid only in the server process that issued it. The server skips duplicates and creates the destination deck when needed. An interactive quiz uses a dedicated note type that is created on first use.

Inputs: previewToken (required).

export_sat_quizExport a fillable SAT quiz as HTMLA

Save a self-contained interactive questionnaire. Open the file in any modern browser to choose answers, submit, see a score and review explanations. Works offline and does not change Anki.

Inputs: deck (required), questions (required).

export_sat_tsvExport individual SAT flashcards for AnkiA

Save an import-ready TSV with the requested deck, styled question and answer cards, and tags. Works without AnkiConnect and does not change the Anki collection. Returns the file path.

Inputs: deck (required), questions (required).

list_decksList Anki decksA
Read-onlyIdempotent

List the names of all decks in the local Anki collection. Read-only.

Inputs: no named parameters.

preview_sat_questionsPreview SAT multiple-choice questionsA
Read-only

Validate SAT multiple-choice questions (exactly four choices A to D and one answer letter) and show the Anki notes they would create, with all text HTML-escaped. Reports which questions already exist in Anki, matched by tag, and whether the deck exists. If the deck is missing, says that commit_sat_preview will create it. Writes nothing to Anki. Returns a previewToken that expires in 10 minutes and works only in this server process. Pass it to commit_sat_preview to add the new questions.

Inputs: deck (required), questions (required).

preview_sat_quizPreview an interactive SAT questionnaireA
Read-only

Preview one interactive Anki card containing the whole questionnaire. The student can choose answers, submit, see a score, and review explanations. Returns a one-time previewToken and does not write to Anki.

Inputs: deck (required), questions (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 7 tools

    Disambiguation4/5

    The preview tools split cleanly by output (preview_sat_questions for individual notes, preview_sat_quiz for one interactive card), and the two exports differ clearly (offline HTML vs import TSV). The only real overlap is list_decks vs check_deck, since existence could be inferred from a full listing, though the case-insensitive exact-name lookup gives check_deck a distinct role.

    Naming Consistency5/5

    All seven tools follow a strict snake_case verb_noun pattern (list_decks, check_deck, preview_*, commit_*, export_*), with a consistent 'sat' domain qualifier on the domain-specific tools. The preview/commit and export pairings are named symmetrically, making the workflow legible from names alone.

    Tool Count5/5

    Seven tools is well-scoped for a focused workflow: discover decks, preview in two modes, commit once, and export in two formats. Every tool maps to a distinct step and none appears redundant.

    Completeness4/5

    The core lifecycle (list/check deck, preview with duplicate detection, commit with token safety, two export paths) is fully covered for getting SAT questions into Anki. There are minor gaps: no way to update or delete existing notes/questions, and no dedicated tool to list current SAT notes beyond the tag matching inside preview.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers