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.
El servidor usa MCP JSONL por stdio. No abre un puerto de red por defecto.
Related MCP server: Persistent Terminal MCP Server
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.
os_create_session crea una sesión persistente.
os_send_input escribe inmediatamente en el PTY/ConPTY.
os_read_output usa since_seq para buscar solo salida nueva.
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.
Flujo recomendado:
os_create_session crea el terminal persistente.
os_goal_start recibe el objetivo, criterios y session_id.
os_send_input usa el goal_id para ejecutar sin confirmación repetitiva.
os_read_output lee la salida incremental.
os_goal_update registra acción, resultado, evidencia y siguiente paso.
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.
git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txtEn 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.
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.
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.
