os-control-mcp

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.

Transport

Der Server verwendet MCP JSONL über stdio. Er öffnet standardmäßig keinen Netzwerk-Port.

Related MCP server: Persistent Terminal MCP Server

Shells

• 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.

Interaktiver Ablauf

1. os_create_session erstellt eine persistente Sitzung.

2. os_send_input schreibt sofort in das PTY/ConPTY.

3. os_read_output verwendet since_seq, um nur neue Ausgaben abzurufen.

4. 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.

Autonome Ziele

Empfohlener Ablauf:

1. os_create_session erstellt das persistente Terminal.

2. os_goal_start empfängt das Ziel, die Kriterien und die session_id.

3. os_send_input verwendet die goal_id, um ohne wiederholte Bestätigung auszuführen.

4. os_read_output liest die inkrementelle Ausgabe.

5. os_goal_update protokolliert Aktion, Ergebnis, Beweis und nächsten Schritt.

6. 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.

Installation

git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txt

Unter 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.

Plugin für GPT/Codex

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.