NPCterm: Vollständiger PTY-Terminal-Emulator für KI-Agenten über MCP

NPCterm ist ein headless, im Speicher laufender vollständiger PTY-Terminalemulator für KI-Agenten, bereitgestellt über MCP (Model Context Protocol). Es gewährt KI-Agenten vollen Terminalzugriff, nicht nur Bash, sodass sie Shells starten, beliebige Befehle ausführen, Bildschirmausgaben lesen, Tastatureingaben senden und mit TUI-Anwendungen interagieren können.

Hauptmerkmale

• Vollständige ANSI/VT100-Terminalemulation mit PTY-Erzeugung über portable-pty
• 15 MCP-Tools für vollständige Terminalsteuerung über JSON-RPC stdio
• Prozesszustandserkennung – erkennt, ob ein Befehl läuft, im Leerlauf ist, auf Eingabe wartet oder beendet wurde
• Ereignissystem – Ringpuffer von Terminalereignissen (CommandFinished, WaitingForInput, Bell, etc.)
• KI-freundliche Koordinatenüberlagerung für präzise Bildschirmnavigation
• Maus-, Auswahl- und Scroll-Unterstützung für die Interaktion mit TUI-Anwendungen
• Mehrere gleichzeitige Terminals mit kurzen 2-Zeichen-IDs

Beispielhafter MCP-Ablauf

Die Quelle bietet ein konkretes Beispiel für die Verwendung von NPCterm zum Öffnen und Beenden von Vim:

// 1. Terminal erstellen
// -> terminal_create {}
// <- {"id": "a0", "cols": 80, "rows": 24}

// 2. Vim öffnen
// -> terminal_send_keys {"id": "a0", "input": [{"text": "vim"}, {"key": "Enter"}]}
// <- {"success": true}
// 3. Bildschirm lesen, um zu bestätigen, dass Vim geöffnet ist
// -> terminal_show_screen {"id": "a0"}
// <- ~ VIM - Vi IMproved
// <- ~ version 9.2.250
// <- ~ by Bram Moolenaar et al.
// <- ~ type :q<Enter> to exit
// <- ...
// 4. Vim beenden
// -> terminal_send_keys {"id": "a0", "input": [{"text": ":q"}, {"key": "Enter"}]}
// <- {"success": true}

Die Quelle enthält eine Warnung: "Mit Vorsicht verwenden. Ein Terminal ist eine uneingeschränkte Ausführungsumgebung." Dieses Tool entspricht effektiv der Gewährung des Zugriffs auf einen Computer für einen KI-Agenten.

Das Projekt ist auf GitHub verfügbar unter github.com/alejandroqh/npcterm.