Clozemaster CLI MCP sunucusu
Commit 11 Kas 2026Yapay zeka asistanlarının doğrudan Clozemaster içine cümleler, çeviriler ve boşluk doldurma (cloze) egzersizleri yazarak dil öğrenme koleksiyonlarını yönetmesine olanak tanır.
Ayrıca bilinen adı langovation/clozemaster-cli
- Yıldızlar
- 5
- Araçlar
- 7
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 11 Kas 2026
- Lisans
- MIT
Clozemaster CLI MCP nedir?
Yapay zeka asistanlarının doğrudan Clozemaster içine cümleler, çeviriler ve boşluk doldurma (cloze) egzersizleri yazarak dil öğrenme koleksiyonlarını yönetmesine olanak tanır. 7 araç sunar; örneğin list_language_pairings, list_collections, create_collection.
Özet, projenin README dosyasından oluşturuldu
Clozemaster CLI MCP sunucusu hakkında
clozemaster-cli, dil öğrenme koleksiyonlarını yapay zeka asistanları aracılığıyla yönetmenizi sağlar. Bu yerel MCP server; Claude, Cursor ve diğer uyumlu yapay zeka istemcilerinin, çalışma materyallerinizi düzenlemek ve doldurmak için doğrudan Clozemaster hesabınızla etkileşime girmesine olanak tanır. stdio üzerinden çalışan sunucu, terminal tabanlı oyun için kullandığınız kimlik bilgilerini kullanarak arka planda çalışır.
Kullanıcılar, bir yapay zekadan belirli içerikler üretmesini isteyerek çalışma setlerinin oluşturulmasını otomatikleştirebilirler. Sunucu; dil eşleşmelerini listelemek, koleksiyonları görüntülemek ve tekil cümleleri yönetmek için araçlar sunar. Temel görüntüleme özellikleri herkes için mevcutken; create_collection, add_sentences, update_sentence ve delete_sentence gibi gelişmiş özellikler Clozemaster Pro hesabı gerektirir. Manuel veri girişi yapmadan, özel kelime listeleri oluşturmak için yapay zekayı kullanmak isteyen geliştiriciler ve dil öğrenenler için tasarlanmıştır.
Neler yapabilirsiniz
- 1Otomatik kelime dağarcığı oluşturmaBir yapay zeka asistanından, belirli bir konu hakkında belirli sayıda cümleyi bir dil koleksiyonuna üretmesini ve eklemesini isteyin.
- 2Koleksiyon organizasyonuMevcut dil eşleşmelerinizi ve koleksiyonlarınızı tarayıp belirli çalışma setlerini bulmak için yapay zekayı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Clozemaster CLI MCP araçları 7
README dosyasından algılandılist_language_pairingslist_collectionscreate_collectionlist_sentencesadd_sentencesupdate_sentencedelete_sentence
| list_language_pairings | — | |
| list_collections | — | |
| create_collection | — | |
| list_sentences | — | |
| add_sentences | — | |
| update_sentence | — | |
| delete_sentence | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirlangovation/clozemaster-cli is public and reachablegithub.com/langovation/clozemaster-cli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-11github.com/langovation/clozemaster-cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Clozemaster 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.
Clozemaster CLI MCP soruları
Clozemaster CLI MCP hangi araçları sunar?
7 araç sunar; bunlar arasında list_language_pairings, list_collections, create_collection, list_sentences, add_sentences yer alır.
Clozemaster MCP server neler yapabilir?
Yapay zeka uygulamalarının doğrudan kişisel Clozemaster koleksiyonlarınıza cümleler, çeviriler ve boşluk doldurma egzersizleri yazmasını sağlar.
Clozemaster CLI oturumunu nasıl açarım?
CLI'ı ilk kez kullandığınızda, web tarayıcınız üzerinden oturum açmanız istenecektir.