Servidor MCP de Controlador de Terminal

¿Qué hace el Servidor MCP “Controlador de Terminal”?

El Servidor MCP de Controlador de Terminal es un servidor del Modelo de Protocolo de Contexto (MCP) diseñado para permitir la ejecución segura de comandos en terminal, navegación de directorios y operaciones en el sistema de archivos mediante una interfaz estandarizada. Actúa como puente entre los asistentes de IA y el entorno anfitrión, permitiendo que los agentes de IA realicen tareas como ejecutar comandos shell, gestionar directorios y manipular archivos de forma programática. Con protecciones de seguridad incorporadas, seguimiento de historial de comandos y compatibilidad multiplataforma, Controlador de Terminal mejora los flujos de trabajo de desarrollo al brindar a herramientas potenciadas por IA acceso controlado al terminal y sistema de archivos de una máquina. Esta capacidad permite a los asistentes de IA automatizar, explorar y gestionar tareas a nivel de sistema para desarrolladores de manera segura y estandarizada.

Lista de Prompts

No se encontraron plantillas de prompt en el repositorio o la documentación.

Lista de Recursos

No se definieron recursos MCP explícitos en el repositorio o la documentación.

Lista de Herramientas

• Ejecución de Comandos: Permite ejecutar comandos de terminal con controles de tiempo de espera y captura de salida completa.
• Gestión de Directorios: Habilita navegación y listado de contenidos de directorios con formato intuitivo.
• Operaciones de Archivos: Soporta leer, escribir, actualizar, insertar y borrar contenido de archivos con precisión a nivel de fila.
• Historial de Comandos: Rastrea y muestra ejecuciones recientes de comandos para auditoría y repetibilidad.

Casos de Uso de este Servidor MCP

• Ejecución Automática de Comandos: Los desarrolladores pueden indicar a asistentes de IA que ejecuten comandos shell de forma segura para construir, probar o desplegar código, con salida y errores capturados.
• Gestión de Directorios y Archivos: Los agentes de IA pueden ayudar a organizar, explorar o manipular archivos y carpetas, facilitando la automatización de la exploración de bases de código o la configuración de entornos.
• Scripting con Conciencia de Seguridad: Las protecciones integradas ayudan a prevenir comandos peligrosos, reduciendo el riesgo al otorgar acceso de terminal a la IA.
• Monitoreo y Auditoría del Sistema: Las funciones de historial de comandos permiten rastrear qué acciones se realizaron, ayudando en auditorías y transparencia de flujos de trabajo.
• Desarrollo Multiplataforma: Al soportar tanto Windows como sistemas basados en UNIX, el servidor MCP facilita experiencias de desarrollo consistentes en entornos diversos.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Python 3.11+ instalado.
2. Instala el paquete vía PyPI:

   pip install terminal-controller
   

3. Edita tu archivo de configuración de Windsurf para añadir el servidor MCP:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Guarda la configuración y reinicia Windsurf.
5. Verifica que el servidor MCP esté en ejecución y accesible.

Claude

1. Instala Python 3.11+ en tu máquina.
2. Para Claude Desktop, instala vía Smithery:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Alternativamente, instala vía PyPI:

   pip install terminal-controller
   

4. Añade lo siguiente a tu configuración de Claude:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Reinicia Claude Desktop y asegúrate de que se detecte el servidor MCP.

Cursor

1. Asegúrate de tener Node.js y Python 3.11+ instalados.
2. Instala terminal-controller:

   pip install terminal-controller
   

3. Añade el servidor MCP a tu configuración de Cursor:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Guarda el archivo y reinicia Cursor.
5. Confirma la integración revisando la lista de herramientas en Cursor.

Cline

1. Asegúrate de que Python 3.11+ esté disponible.
2. Instala el servidor MCP:

   pip install terminal-controller
   

3. Añade el siguiente fragmento a tu configuración de Cline:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Reinicia Cline después de guardar los cambios.
5. Prueba ejecutando un comando simple a través de la interfaz MCP.

Protección de Claves API

Si se requieren claves API o secretos para tu configuración, utiliza variables de entorno en vez de codificarlas directamente. Ejemplo de configuración:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “terminal-controller” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Basado en lo anterior, el Controlador de Terminal MCP proporciona acceso esencial al terminal y sistema de archivos de forma segura, pero carece de plantillas de prompt y recursos explícitos. Su configuración está bien documentada y es multiplataforma. No se mencionan roots ni muestreo. En general, es un servidor práctico, seguro y relativamente simple para necesidades básicas de DevOps o automatización.

Puntuación MCP