MCP server de Clozemaster CLI
Commit 11 nov 2026Permite que los asistentes de IA gestionen colecciones de aprendizaje de idiomas escribiendo oraciones, traducciones y clozes directamente en Clozemaster.
También conocido como langovation/clozemaster-cli
- Stars
- 5
- Herramientas
- 7
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es Clozemaster CLI MCP?
Permite que los asistentes de IA gestionen colecciones de aprendizaje de idiomas escribiendo oraciones, traducciones y clozes directamente en Clozemaster. Expone 7 herramientas, como list_language_pairings, list_collections, create_collection.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Clozemaster CLI
clozemaster-cli permite gestionar colecciones de aprendizaje de idiomas mediante asistentes de IA. Este MCP server local permite que Claude, Cursor y otros clientes de IA compatibles interactúen directamente con tu cuenta de Clozemaster para organizar y poblar tus materiales de estudio. Al ejecutarse sobre stdio, el servidor funciona en segundo plano utilizando las mismas credenciales que usas para el juego basado en terminal.
Los usuarios pueden automatizar la creación de sets de estudio pidiéndole a una IA que genere contenido específico. El servidor proporciona herramientas para listar combinaciones de idiomas, ver colecciones y gestionar oraciones individuales. Aunque la visualización básica está disponible para todos, las funciones avanzadas como create_collection, add_sentences, update_sentence y delete_sentence requieren una cuenta Clozemaster Pro. Está diseñado para desarrolladores y estudiantes de idiomas que quieran usar IA para crear listas de vocabulario personalizadas sin tener que introducir datos manualmente.
Qué puedes hacer con él
- 1Construcción automatizada de vocabularioPide a un asistente de IA que genere y añada un número específico de oraciones sobre un tema a una colección de idiomas.
- 2Organización de coleccionesUsa una IA para explorar tus combinaciones de idiomas y colecciones existentes para encontrar sets de estudio específicos.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de Clozemaster CLI MCP 7
Detectado desde el READMElist_language_pairingslist_collectionscreate_collectionlist_sentencesadd_sentencesupdate_sentencedelete_sentence
| list_language_pairings | — | |
| list_collections | — | |
| create_collection | — | |
| list_sentences | — | |
| add_sentences | — | |
| update_sentence | — | |
| delete_sentence | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblelangovation/clozemaster-cli is public and reachablegithub.com/langovation/clozemaster-cli ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/langovation/clozemaster-cli ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubClozemaster CLI
One clozemaster command does two things:
- CLI: play Clozemaster in your terminal, with multiple choice, text input, listening or flashcards, and pixel art.
- MCP server: let Claude and other AI apps write sentences into your own Clozemaster collections.
Both use the same install and the same login.
https://github.com/user-attachments/assets/2fcd2f4b-a4c4-4692-9848-4a7160cb1b7c
Install
One line installs a clozemaster command on macOS or Linux:
curl -fsSL https://www.clozemaster.com/install-cli.sh | sh
The installer downloads the executable for your platform from the latest GitHub release and checks it against the release's SHA256SUMS. That catches a corrupted or truncated download; it isn't a signature, so it doesn't prove who built the file.
CLI: play in your terminal
Type clozemaster to play. The first time, it asks you to log in with your browser.
Commands
| Command | What it does |
|---|---|
clozemaster |
Play (logs you in first if needed) |
clozemaster login |
Log in again with your browser |
clozemaster logout |
Forget your login on this machine |
clozemaster --version |
Print the version (also -v or version) |
Keys
While playing: 1-4 picks an answer, → gives one hint per sentence, tab switches answer mode, p replays the audio, h replays it at half speed, e explains the sentence, s opens settings and esc goes back to the menu. In flashcards, space reveals, then 1 again, 2 good or k known. Press c on the menu for Quick Capture and f to email feedback to support@clozemaster.com.
MCP: let AI apps manage your collections
clozemaster mcp lets an AI app write sentences straight into your own Clozemaster collections. Ask it something like "add 10 sentences about cooking to my German collection" and it writes the sentences, translations and clozes for you.
How it works
It's a local MCP server that talks over stdio. Your AI app starts it in the background whenever it needs it, so you never run it yourself. It uses the login saved by clozemaster. If you haven't logged in yet, the first request opens your browser to log in, and the AI can carry on once you approve it.
Tools
| Tool | What it does |
|---|---|
list_language_pairings |
The languages you're learning, with the ids the other tools need |
list_collections |
Your own collections in a language |
create_collection |
Make a new, empty collection (needs Clozemaster Pro) |
list_sentences |
Page through a collection's sentences |
add_sentences |
Add sentences to a collection (needs Clozemaster Pro) |
update_sentence |
Change a sentence's text and translation (needs Clozemaster Pro) |
delete_sentence |
Delete a sentence (needs Clozemaster Pro) |
A typical session: the AI lists your language pairings, picks or creates a collection, then adds sentences to it. It only touches collections you own, and it doesn't play rounds.
Add it to Claude Code
claude mcp add -s user clozemaster -- clozemaster mcp
-s user makes it available in every project, not just the folder you run it in.
Add it to Claude Desktop
Claude Desktop doesn't see your shell's PATH, so give it the full path to the binary. which clozemaster prints it; the installer puts it at ~/.local/bin/clozemaster.
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"clozemaster": { "command": "/Users/you/.local/bin/clozemaster", "args": ["mcp"] }
}
}
Add it to other AI apps
Any app that runs local stdio MCP servers works. Give it the command clozemaster (or its full path) with the argument mcp.
Cursor (~/.cursor/mcp.json) and Gemini CLI (~/.gemini/settings.json) use the same shape as Claude Desktop:
{
"mcpServers": {
"clozemaster": { "command": "clozemaster", "args": ["mcp"] }
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"clozemaster": { "type": "stdio", "command": "clozemaster", "args": ["mcp"] }
}
}
Codex CLI (~/.codex/config.toml):
[mcp_servers.clozemaster]
command = "clozemaster"
args = ["mcp"]
ChatGPT
Not yet. ChatGPT only connects to remote MCP servers over HTTPS, not to commands on your computer. It needs a hosted Clozemaster MCP server, which doesn't exist yet.
Uninstall
clozemaster logout
claude mcp remove clozemaster # only if you added it to Claude Code
rm ~/.local/bin/clozemaster
rm -rf ~/.config/clozemaster ~/.cache/clozemaster
If ~/.local/bin wasn't already on your PATH, the installer added a line like export PATH="/Users/you/.local/bin:$PATH" to your shell profile: ~/.zshrc for zsh, ~/.bash_profile for bash on macOS, ~/.bashrc for bash on Linux, or ~/.profile for other shells. Delete that line if nothing else needs it.
Development
Needs Node 20 or newer.
git clone https://github.com/langovation/clozemaster-cli.git
cd clozemaster-cli
npm install
npm run dev # run from source
npm test
npm run build # bundles to dist/cli.js
npm link # after a build, puts `clozemaster` on your PATH
npm run install:local # builds the executable and installs it to ~/.local/bin
Environment variables:
CLOZEMASTER_URL: server to play against, e.g.http://localhost:3000(defaulthttps://www.clozemaster.com)CLOZEMASTER_TOKEN: use this API auth token instead of logging inCLOZEMASTER_NO_AUTO_UPDATE: set to1to stop the executable updating itselfCLOZEMASTER_RELEASES_URL: where the executable downloads updates from (default the GitHub releases); the release workflow points it at a local server to test updating before publishing
Release a new version
npm run release -- 0.2.0
From a clean, pushed main, the script:
- Bumps
versioninpackage.json, commits it, tagsv0.2.0and pushes both. - Waits for the release workflow (
.github/workflows/release.yml), which runs the tests, builds an executable for each platform and publishes them withSHA256SUMSas the latest GitHub release.install.shalways downloads from the latest release. - Checks the release has all five files.
- Opens a web repo PR setting
lib/cli/cli-version.txtto the new version. Installed CLIs and MCP servers check that file at most once an hour and, if it's newer, download that release's executable in the background, check it againstSHA256SUMS, check it runs, and swap it in for the next launch, so merge it last. The script looks for the web repo next to this one; setCLOZEMASTER_WEB_REPOif it's elsewhere.
The copy of install.sh served at clozemaster.com lives in the web repo at lib/cli/install-cli.sh.
License
The code is MIT. The Clozemaster name, logo, pixel art and sound effects are not; see TRADEMARKS.md.
Preguntas sobre Clozemaster CLI MCP
¿Qué herramientas proporciona Clozemaster CLI MCP?
Expone 7 herramientas, incluidas list_language_pairings, list_collections, create_collection, list_sentences, add_sentences.
¿Qué puede hacer el MCP server de Clozemaster?
Permite que las aplicaciones de IA escriban oraciones, traducciones y clozes directamente en tus colecciones personales de Clozemaster.
¿Cómo inicio sesión en el CLI de Clozemaster?
La primera vez que uses el CLI, se te pedirá que inicies sesión a través de tu navegador web.