🥋 miyagi

忍耐強く、ゲーム化され、音声対応のMCPコーディングチューター。 あなたがコマンドを実行します。それは練習させ、修正し、失敗をキャッチし、スコアを記録します。

ワックスを塗って、拭き取る。miyagi は決してあなたの代わりに作業をしません。次のコマンドを手渡し、あなたのレベルに合わせて説明し、すべての結果をレッスンに変えます。各実行はティーチングカードとして返ってきます：ロードマップ上の現在位置、あなたの経験に合わせた What/How/Trade-offs の内訳、Mermaid のメンタルモデル、人々が陥りがちな落とし穴、厳選されたドキュメント、そしてアクティブリコールクイズ。そのすべてが OS の音声エンジンでナレーションされます。

インストールしても安全な理由

あなたのマシンでシェルコマンドを実行するため、信頼する前に読まれるように設計されています。

• 壊滅的なものは実行されません。 rm -rf、dd of=/dev/*、フォーク爆弾、curl | sh、強制プッシュ、chmod -R 777 はパターンマッチされ、呼び出し元のモデルが何を主張しても ドライランに強制されます。このスクリーンは、不注意なユーザーだけでなく、混乱した AI からも防御します。そのため、渡された is_dangerous フラグを信頼するのではなく、判定を再導出します。

• 拒否リストはバックストップであり、サンドボックスではありません。 実際の境界は、MCP クライアント自身の承認プロンプトであり、コマンドが実行される前にあなたがそれを読みます。スクリーンは、そのプロンプトがうまく処理できない狭いケースのために存在します：クリックして進んでいる人に提案される明らかに破壊的な何か。

• 失敗はクラッシュする代わりに教えます。 非ゼロの終了コードは、トラブルシューティングラダーを備えたホットフィックス診断を返します。サーバーは決して例外を投げません。

• 制限付き。 60秒のタイムアウト、4 MBの出力上限、ネットワーク呼び出しなし、テレメトリなし、APIキーなし、アカウントなし。

• 監査できるほど小さい。 2つのランタイム依存関係（MCP SDK と zod）が、一読できる1つのソースファイルにあります。

Related MCP server: EduChain MCP Server

インストール

MCP クライアントを npx に向けると、初回実行時に取得されます：

npx -y miyagi-mcp

または、グローバルにインストールすると、miyagi コマンドが使えます：

npm install -g miyagi-mcp

git clone https://github.com/c00p75/miyagi.git
cd miyagi
npm install
npm run build      # emits dist/miyagi.js
npm test

次に、以下の設定で "command": "node", "args": ["<ABS_PATH>/dist/miyagi.js"] を使用します。

MCP クライアントの設定

3行で、どこでも同じです。キーもアカウントも不要で、すべてローカルで動作します。

{
  "mcpServers": {
    "miyagi": {
      "command": "npx",
      "args": ["-y", "miyagi-mcp"]
    }
  }
}

その場所は：

Claude Code の場合は、1つのコマンドで完了します：

claude mcp add miyagi -- npx -y miyagi-mcp

クライアントを再起動して、次のように試してください：「ロードマップをバックエンド開発者に設定して、docker compose config を教えてください。」

内容

音声エンジン

オーディオが必要な Linux ユーザー: sudo apt install speech-dispatcher。

ツール

• quick_config: スキルレベル（ジュニア/ミッド/シニア）、カテゴリ、トラック、トピック、または音声を1回の呼び出しで切り替えます。reset_progress: true を渡すと、保存された XP を初回実行状態に戻します。

• set_active_roadmap: カテゴリ、ロードマップ、トピック、ステップカウンターを設定します。

• get_next_roadmap_command: 次にコピー＆ペースト可能なコマンドを取得します。advance: true で前進します。

• configure_voice: オーディオの切り替え、1分あたりの単語数の設定、テストフレーズの読み上げ

• get_user_stats: XP、レベル、タイトル、ストリーク、バッジ、タイトルラダー

• run_teaching_command: コマンドを実行またはドライランし、ティーチングカードを返します。

• verify_quiz_answer: クイズを採点し、ストリークと XP を更新し、フィードバックを読み上げます。

• export_roadmap_notes: ROADMAP_PROGRESS.md を書き出します。

進捗の保存場所

~/.miyagi/profile.json には、XP、レベル、ストリーク、バッジ、スキルレベル、音声設定、ロードマップの位置が保存されます。ディレクトリは MIYAGI_HOME で上書きできます。これはテストが実際のプロファイルに触れないようにする方法でもあります。

このファイルは読み込み時に信頼されないものとして扱われます。手動で編集可能であり、クラッシュで切り詰められる可能性があるためです。パースに失敗したものはエラーとして発生させる代わりに新しいプロファイルに置き換えられ、範囲外の値は拒否されるのではなくクランプされ、レベルは読み取るのではなく XP から再計算されるため、40 XP でレベル99と主張するファイルは修正されます。書き込みは一時ファイルに行われ、リネームされるため、書き込みが中断されても以前のプロファイルはそのまま残ります。

開発

npm install
npm run typecheck
npm test           # node:test, no test framework to install
npm run build

CI は Node 18、20、22 に対して型チェック、テスト、実際の stdio ハンドシェイクを実行します。

知っておくべき制限

• コマンドはあなた自身の権限で、あなた自身のディレクトリで実行されます。コンテナも、制限されたユーザーも、システムコールフィルターもありません。これは所有者が操作するローカルな教育ツールには適切ですが、信頼できない入力を受け入れるようになった場合に最初に変更すべき点です。

• 長時間実行されるコマンドや対話型コマンドは、自分のターミナルで実行してください。60秒の上限で切断されます。

• XP とストリークが実際に誰かをロードマップに留めるかどうかは未解決の疑問です。進捗ファイルがあれば、それに答えることができます。

ライセンス

MIT