🥋 miyagi

Ein geduldiger, spielerischer, sprachgesteuerter MCP-Coding-Tutor. Du führst die Befehle aus. Es übt, korrigiert, fängt die Stürze ab und führt Punktestand.

Wachs auf, wachs ab. miyagi macht die Arbeit nie für dich. Es reicht dir den nächsten Befehl, erklärt ihn auf deinem Niveau und macht aus jedem Ergebnis eine Lektion. Jeder Durchlauf kommt als Lehrkarte zurück: wo du auf der Roadmap stehst, eine Was/Wie/Kompromisse-Aufschlüsselung, die auf deine Erfahrung zugeschnitten ist, ein Mermaid-Mentales-Modell, die Fallstricke, die Leute beißen, kuratierte Doku und ein Active-Recall-Quiz. Alles wird über die Sprach-Engine deines Betriebssystems erzählt.

Warum es sicher zu installieren ist

Es führt Shell-Befehle auf deinem Rechner aus, also ist es so gebaut, dass man es liest, bevor man ihm vertraut.

• Nichts Katastrophales wird ausgeführt. rm -rf, dd of=/dev/*, Fork-Bomben, curl | sh, Force-Pushes und chmod -R 777 werden per Musterabgleich erkannt und unabhängig davon, was das aufrufende Modell behauptet, in den Dry-Run gezwungen. Der Bildschirm schützt vor einer verwirrten KI, nicht nur vor einem unachtsamen Benutzer, weshalb er das Urteil neu ableitet, anstatt dem is_dangerous-Flag zu vertrauen, das ihm übergeben wurde.

• Eine Denylist ist ein Sicherheitsnetz, keine Sandbox. Die eigentliche Grenze ist der eigene Genehmigungsdialog deines MCP-Clients, bei dem du den Befehl liest, bevor er ausgeführt wird. Der Bildschirm existiert für den engeren Fall, den dieser Dialog schlecht behandelt: etwas offensichtlich Destruktives, das jemandem vorgeschlagen wird, der einfach durchklickt.

• Fehler lehren, statt abzustürzen. Ein Exit-Code ungleich Null liefert eine Hotfix-Diagnose mit einer Fehlerbehebungsleiter. Der Server wirft nie eine Exception.

• Begrenzt. 60-Sekunden-Timeout, 4-MB-Ausgabelimit, keine Netzwerkaufrufe, keine Telemetrie, keine API-Schlüssel, keine Konten.

• Klein genug zum Prüfen. Zwei Laufzeitabhängigkeiten, das MCP SDK und zod, in einer Quelldatei, die du in einer Sitzung lesen kannst.

Related MCP server: EduChain MCP Server

Installation

Richte deinen MCP-Client auf npx aus, und er lädt es beim ersten Start herunter:

npx -y miyagi-mcp

Oder installiere es global, was dir einen miyagi-Befehl gibt:

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

Verwende dann "command": "node", "args": ["<ABS_PATH>/dist/miyagi.js"] in der folgenden Konfiguration.

Konfiguriere deinen MCP-Client

Drei Zeilen, überall gleich. Keine Schlüssel, keine Konten, und alles läuft lokal.

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

Wo das hinkommt:

Für Claude Code genügt ein Befehl:

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

Starte den Client neu und versuche dann: "Setze meine Roadmap auf Backend-Entwickler und bring mir docker compose config bei."

Was ist enthalten

Sprach-Engines

Linux-Benutzer, die Audio wünschen: sudo apt install speech-dispatcher.

Werkzeuge

• quick_config: Wechsle in einem Aufruf das Kenntnisniveau (Junior/Mid/Senior), Kategorie, Track, Thema oder Stimme. Übergib reset_progress: true, um gespeicherte XP auf den Erststart-Zustand zurückzusetzen.

• set_active_roadmap: Setze Kategorie, Roadmap, Thema und Schritt-Zähler

• get_next_roadmap_command: den nächsten kopier- und einfügbaren Befehl, mit advance: true zum Vorrücken

• configure_voice: Audio umschalten, Wörter pro Minute einstellen, einen Testsatz sprechen

• get_user_stats: XP, Level, Titel, Streaks, Abzeichen, Titelleiter

• run_teaching_command: einen Befehl ausführen oder im Dry-Run ausführen und die Lehrkarte zurückgeben

• verify_quiz_answer: das Quiz bewerten, Streak und XP aktualisieren, das Feedback sprechen

• export_roadmap_notes: ROADMAP_PROGRESS.md schreiben

Wo der Fortschritt gespeichert wird

~/.miyagi/profile.json, das XP, Level, Streaks, Abzeichen, dein Kenntnisniveau, Spracheinstellungen und die Roadmap-Position enthält. Überschreibe das Verzeichnis mit MIYAGI_HOME, was auch der Weg ist, wie die Tests von einem echten Profil fernbleiben.

Die Datei wird beim Zurücklesen als nicht vertrauenswürdig behandelt, da sie von Hand bearbeitet werden kann und ein Absturz sie abschneiden kann. Alles, was nicht geparst werden kann, wird zugunsten eines frischen Profils verworfen, anstatt als Fehler gemeldet zu werden. Werte außerhalb des Bereichs werden geklemmt, anstatt abgelehnt zu werden, und das Level wird aus XP neu berechnet, anstatt gelesen zu werden, sodass eine Datei, die bei 40 XP Level 99 behauptet, korrigiert wird. Schreibvorgänge gehen in eine temporäre Datei und werden umbenannt, sodass ein unterbrochener Schreibvorgang das vorherige Profil intakt lässt.

Entwicklung

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

CI führt Typprüfung, Tests und einen echten Stdio-Handshake gegen Node 18, 20 und 22 aus.

Grenzen, die man kennen sollte

• Befehle laufen mit deinen eigenen Rechten in deinem eigenen Verzeichnis. Kein Container, kein eingeschränkter Benutzer, kein Syscall-Filter. Das ist richtig für ein lokales Lehrtool, das von seinem Besitzer gesteuert wird, und es ist das Erste, was geändert wird, wenn es jemals nicht vertrauenswürdige Eingaben akzeptiert.

• Langlaufende oder interaktive Befehle gehören in dein eigenes Terminal. Die 60-Sekunden-Grenze wird sie abschneiden.

• Ob XP und Streaks jemanden tatsächlich auf einer Roadmap halten, ist eine offene Frage. Die Fortschrittsdatei ist es, die das beantwortbar macht.

Lizenz

MIT