Lokaler MCP-Server für persistente Terminal-Sitzungen. Der Prozess hält Bash, CMD, PowerShell, pwsh oder WSL aktiv und trennt das Senden von Eingaben von der inkrementellen Ausgabe-Lesung.
Er verfügt außerdem über persistente Ziele: Der Agent kann ein Ziel mit Akzeptanzkriterien erstellen, mehrere Schritte ausführen, Beweise prüfen und fortfahren, bis er abgeschlossen, fehlgeschlagen, blockiert ist oder die festgelegten Grenzen erreicht.
Achtung: Dieser Server steuert Prozesse mit den Berechtigungen des Benutzers, der ihn ausführt. Verwenden Sie ihn lokal, führen Sie ihn nicht standardmäßig als Administrator/Root aus und setzen Sie den Prozess niemals direkt dem Internet aus.
Der Server verwendet MCP JSONL über stdio. Er öffnet standardmäßig keinen
Netzwerk-Port.
Related MCP server: Persistent Terminal MCP Server
bash, sh, zsh auf POSIX-Systemen;
cmd, powershell und pwsh unter Windows;
wsl-bash unter Windows, unter Verwendung der in
OS_CONTROL_WSL_DISTRO definierten Distribution oder standardmäßig
kali-linux.
os_create_session erstellt eine persistente Sitzung.
os_send_input schreibt sofort in das PTY/ConPTY.
os_read_output verwendet since_seq, um nur neue Ausgaben abzurufen.
os_session_status verfolgt PID, Shell, Verzeichnis und Beendigung.
Außerhalb eines autonomous-Ziels erfordern potenziell destruktive Befehle eine
explizite Bestätigung. In einem autonomen Ziel ist die Autorisierung innerhalb
der durch das Ziel definierten Schritt- und Zeitlimits kontinuierlich. Der
Server ist für die lokale Nutzung gedacht und sollte weiterhin durch
Authentifizierung und Umfang geschützt bleiben, wenn er hinter einem Remote-Tunnel
platziert wird.
Empfohlener Ablauf:
os_create_session erstellt das persistente Terminal.
os_goal_start empfängt das Ziel, die Kriterien und die session_id.
os_send_input verwendet die goal_id, um ohne wiederholte Bestätigung
auszuführen.
os_read_output liest die inkrementelle Ausgabe.
os_goal_update protokolliert Aktion, Ergebnis, Beweis und nächsten Schritt.
Der Agent wiederholt, bis alle Kriterien nachgewiesen sind.
Der Server erfindet weder die nächste Aktion noch ruft er selbst das Modell auf; er verwaltet den Zustand und die Grenzen des Ziels. Der Client/Agent muss die Aufrufe fortsetzen, bis der Endzustand erreicht ist.
git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txtUnter Windows aktiviert pywinpty ConPTY für CMD und PowerShell. Unter
Kali/Linux verwendet das Backend das native PTY. Die Datei .mcp.json kann von
MCP-Clients verwendet werden, die lokale Server über stdio akzeptieren.
Das Repository enthält das Manifest .codex-plugin/plugin.json und den
MCP-Server. Dadurch kann das Paket an Clients verteilt werden, die mit
MCP-Plugins kompatibel sind.
Für die Verwendung in ChatGPT mit einem lokalen Server muss jeder Benutzer seine eigene Instanz ausführen und eine private Verbindung konfigurieren. Ein GitHub-Repository allein gibt ChatGPT keinen Zugriff auf den Computer des Benutzers.
This server cannot be deployed
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
