Clozemaster CLI MCP server
2026년 11월 11일 커밋AI 어시스턴트가 문장, 번역, 빈칸 채우기(cloze)를 Clozemaster에 직접 작성하여 언어 학습 컬렉션을 관리할 수 있게 합니다.
다른 이름 langovation/clozemaster-cli
- 스타
- 5
- Tools
- 7
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
Clozemaster CLI MCP란?
AI 어시스턴트가 문장, 번역, 빈칸 채우기(cloze)를 Clozemaster에 직접 작성하여 언어 학습 컬렉션을 관리할 수 있게 합니다. 7개 도구를 제공합니다. 예: list_language_pairings, list_collections, create_collection.
프로젝트 README에서 생성된 요약
Clozemaster CLI MCP server 정보
clozemaster-cli를 사용하면 AI 어시스턴트를 통해 언어 학습 컬렉션을 관리할 수 있습니다. 이 로컬 MCP server를 사용하면 Claude, Cursor 및 기타 호환되는 AI 클라이언트가 Clozemaster 계정과 직접 상호작용하여 학습 자료를 정리하고 채울 수 있습니다. stdio를 통해 실행되는 이 server는 터미널 기반 게임에서 사용하는 것과 동일한 자격 증명을 사용하여 백그라운드에서 작동합니다.
사용자는 AI에게 특정 콘텐츠 생성을 요청하여 학습 세트 제작을 자동화할 수 있습니다. 이 server는 언어 쌍 목록 확인, 컬렉션 조회, 개별 문장 관리 기능을 제공합니다. 기본적인 조회 기능은 모두에게 제공되지만, create_collection, add_sentences, update_sentence, delete_sentence와 같은 고급 기능은 Clozemaster Pro 계정이 필요합니다. 이 도구는 수동 데이터 입력 없이 AI를 활용해 맞춤형 어휘 목록을 만들고자 하는 개발자와 언어 학습자를 위해 설계되었습니다.
활용 사례
- 1어휘 구축 자동화AI 어시스턴트에게 특정 주제에 관한 문장을 지정된 개수만큼 생성하여 언어 컬렉션에 추가하도록 요청합니다.
- 2컬렉션 정리AI를 사용하여 기존 언어 쌍과 컬렉션을 탐색하고 특정 학습 세트를 찾습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Clozemaster CLI MCP 도구 7
README에서 감지됨list_language_pairingslist_collectionscreate_collectionlist_sentencesadd_sentencesupdate_sentencedelete_sentence
| list_language_pairings | — | |
| list_collections | — | |
| create_collection | — | |
| list_sentences | — | |
| add_sentences | — | |
| update_sentence | — | |
| delete_sentence | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능langovation/clozemaster-cli is public and reachablegithub.com/langovation/clozemaster-cli ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/langovation/clozemaster-cli ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음7 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
Clozemaster CLI MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: list_language_pairings, list_collections, create_collection, list_sentences, add_sentences.
Clozemaster MCP server로 무엇을 할 수 있나요?
AI 애플리케이션이 사용자의 개인 Clozemaster 컬렉션에 문장, 번역, 빈칸 채우기 데이터를 직접 작성할 수 있습니다.
Clozemaster CLI 로그인은 어떻게 하나요?
CLI를 처음 사용하는 경우, 웹 브라우저를 통해 로그인하라는 메시지가 표시됩니다.