NPCterm: Emulador de Terminal PTY Completo para Agentes de IA a través de MCP

NPCterm es un emulador de terminal PTY completo sin interfaz gráfica y en memoria para agentes de IA, expuesto mediante MCP (Model Context Protocol). Proporciona a los agentes de IA acceso completo al terminal, no solo a bash, permitiéndoles crear shells, ejecutar comandos arbitrarios, leer la salida de pantalla, enviar pulsaciones de teclas e interactuar con aplicaciones TUI.

Características principales

• Emulación completa de terminal ANSI/VT100 con creación de PTY mediante portable-pty
• 15 herramientas MCP para control total del terminal sobre JSON-RPC stdio
• Detección del estado de procesos – sabe cuándo un comando está ejecutándose, inactivo, esperando entrada o ha terminado
• Sistema de eventos – búfer circular de eventos del terminal (CommandFinished, WaitingForInput, Bell, etc.)
• Superposición de coordenadas amigable para IA para navegación precisa en pantalla
• Soporte para ratón, selección y desplazamiento para interactuar con aplicaciones TUI
• Múltiples terminales concurrentes con IDs cortos de 2 caracteres

Ejemplo de flujo MCP

La fuente proporciona un ejemplo concreto de uso de NPCterm para abrir y cerrar Vim:

// 1. Crear un terminal
// -> terminal_create {}
// <- {"id": "a0", "cols": 80, "rows": 24}

// 2. Abrir vim
// -> terminal_send_keys {"id": "a0", "input": [{"text": "vim"}, {"key": "Enter"}]}
// <- {"success": true}
// 3. Leer la pantalla para confirmar que vim está abierto
// -> terminal_show_screen {"id": "a0"}
// <- ~ VIM - Vi IMproved
// <- ~ version 9.2.250
// <- ~ by Bram Moolenaar et al.
// <- ~ type :q<Enter> to exit
// <- ...
// 4. Cerrar vim
// -> terminal_send_keys {"id": "a0", "input": [{"text": ":q"}, {"key": "Enter"}]}
// <- {"success": true}

La fuente incluye una advertencia: "Usar con precaución. Un terminal es un entorno de ejecución sin restricciones." Esta herramienta es efectivamente equivalente a dar a un agente de IA acceso a una computadora.

El proyecto está disponible en GitHub en github.com/alejandroqh/npcterm.