os-control-mcp

MCP local para sesiones persistentes de terminal. El proceso mantiene Bash, CMD, PowerShell, pwsh o WSL activos y separa el envío de entrada de la lectura incremental de la salida.

También posee objetivos persistentes: el agente puede crear un objetivo con criterios de aceptación, ejecutar varios pasos, verificar evidencias y continuar hasta concluir, fallar, quedar bloqueado o alcanzar los límites definidos.

Atención: este servidor controla procesos con los permisos del usuario que lo ejecuta. Úsalo localmente, no lo ejecutes como administrador/root por defecto y nunca expongas el proceso directamente a internet.

Transporte

El servidor usa MCP JSONL por stdio. No abre un puerto de red por defecto.

Related MCP server: Persistent Terminal MCP Server

Shells

• bash, sh, zsh en sistemas POSIX;

• cmd, powershell y pwsh en Windows;

• wsl-bash en Windows, usando la distribución definida en OS_CONTROL_WSL_DISTRO o kali-linux por defecto.

Flujo interactivo

1. os_create_session crea una sesión persistente.

2. os_send_input escribe inmediatamente en el PTY/ConPTY.

3. os_read_output usa since_seq para buscar solo salida nueva.

4. os_session_status acompaña PID, shell, directorio y cierre.

Fuera de un objetivo autonomous, los comandos potencialmente destructivos requieren confirmación explícita. En un objetivo autónomo, la autorización es continua dentro de los límites de pasos y tiempo definidos por el objetivo. El servidor está destinado a uso local y debe continuar protegido por autenticación y alcance cuando se coloque detrás de un túnel remoto.

Objetivos autónomos

Flujo recomendado:

1. os_create_session crea el terminal persistente.

2. os_goal_start recibe el objetivo, criterios y session_id.

3. os_send_input usa el goal_id para ejecutar sin confirmación repetitiva.

4. os_read_output lee la salida incremental.

5. os_goal_update registra acción, resultado, evidencia y siguiente paso.

6. El agente repite hasta comprobar todos los criterios.

El servidor no inventa la siguiente acción ni llama al modelo por sí mismo; mantiene el estado y los límites del objetivo. El cliente/agente debe continuar haciendo las llamadas hasta el estado terminal.

Instalación

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

En Windows, pywinpty habilita ConPTY para CMD y PowerShell. En Kali/Linux, el backend usa el PTY nativo. El archivo .mcp.json puede ser usado por clientes MCP que acepten servidores locales por stdio.

Plugin para GPT/Codex

El repositorio contiene el manifiesto .codex-plugin/plugin.json y el servidor MCP. Esto permite distribuir el paquete a clientes compatibles con plugins MCP.

Para usar en ChatGPT con un servidor local, cada usuario debe ejecutar su propia instancia y configurar una conexión privada. Un repositorio GitHub, por sí solo, no le da a ChatGPT acceso al ordenador del usuario.