Clozemaster CLI MCPサーバー
コミット 2026年11月11日AIアシスタントがClozemasterに文章、翻訳、穴埋め問題(clozes)を直接書き込み、語学学習コレクションを管理できるようにします。
別名 langovation/clozemaster-cli
- スター
- 5
- ツール
- 7
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月11日
- ライセンス
- MIT
Clozemaster CLI MCPとは
AIアシスタントがClozemasterに文章、翻訳、穴埋め問題(clozes)を直接書き込み、語学学習コレクションを管理できるようにします。 7個のツールを提供しており、list_language_pairings, list_collections, create_collectionなどがあります。
プロジェクトのREADMEから生成された概要
Clozemaster CLI MCP server について
clozemaster-cliは、AIアシスタントを通じて語学学習コレクションを管理することを可能にします。このローカルMCP serverを使用すると、Claude、Cursor、その他の互換性のあるAIクライアントがClozemasterアカウントと直接やり取りし、学習教材の整理や追加を行えます。stdio経由で動作するため、ターミナルベースのゲームで使用するのと同じ認証情報を使用して、サーバーがバックグラウンドで動作します。
ユーザーは、AIに特定のコンテンツの生成を依頼することで、学習セットの作成を自動化できます。このサーバーは、言語ペアのリスト表示、コレクションの閲覧、個々の文章の管理を行うためのツールを提供します。閲覧などの基本機能はすべてのユーザーが利用可能ですが、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を初めて使用する際に、ウェブブラウザ経由でのログインが求められます。