Terminal Controller MCP
by GongRzhe
Ejecución segura de comandos de terminal y operaciones de archivos mediante asistentes de IA
devops Python Intermedio Auto-hospedable Sin API key
⭐ 99 stars 📅 Actualizado: hace 9m
Descripción
Un servidor MCP para ejecución segura de comandos de terminal, navegación de directorios y operaciones del sistema de archivos. Proporciona 10 herramientas que cubren ejecución de comandos con controles de timeout, navegación de directorios, lectura/escritura de archivos con precisión a nivel de fila, y seguimiento del historial de comandos. Incluye salvaguardas de seguridad integradas con listas negras de comandos para prevenir operaciones peligrosas.
✅ Ideal para
Equipos que quieren acceso a terminal asistido por IA con controles de seguridad y capacidades de edición de archivos
⏭️ No recomendado si
Necesitas acceso a shell sin restricciones o sesiones de terminal interactivas
💡 Casos de uso
- Ejecutar comandos de shell a través de asistentes de IA con protecciones de seguridad
- Navegar y listar contenidos de directorios
- Leer y editar archivos con precisión a nivel de fila
- Rastrear historial de ejecución de comandos para auditoría
- Automatizar flujos de trabajo de terminal con guía de IA
👍 Ventajas
- ✓ Seguridad integrada con lista negra de comandos peligrosos
- ✓ Operaciones de archivo a nivel de fila (leer, escribir, insertar, actualizar, eliminar)
- ✓ Seguimiento del historial de comandos para auditabilidad
- ✓ Soporte multiplataforma (Windows y UNIX)
👎 Desventajas
- ✗ La lista negra de comandos puede ser demasiado restrictiva para algunos casos
- ✗ Sin soporte para comandos de terminal interactivos
- ✗ Requiere Python 3.11+
🔧 Herramientas expuestas (10 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| execute_command | command | Ejecutar comandos de terminal con controles de timeout y captura de salida |
| get_command_history | command | Recuperar registros recientes de ejecución de comandos |
| read_file | file-operations | Leer contenido de archivo con selección opcional de rango de filas |
| write_file | file-operations | Escribir o añadir contenido a archivos con verificación |
| insert_file_content | file-operations | Insertar contenido en posiciones de fila especificadas |
| update_file_content | file-operations | Actualizar contenido en posiciones de fila específicas |
| delete_file_content | file-operations | Eliminar contenido de posiciones de fila específicas |
| get_current_directory | navigation | Devolver la ruta del directorio de trabajo actual |
| change_directory | navigation | Cambiar a una ruta de directorio especificada |
| list_directory | navigation | Mostrar contenidos del directorio con iconos formateados |
💡 Consejos y trucos
Usa execute_command con timeout para operaciones de larga duración. Las herramientas de archivos soportan precisión a nivel de fila — usa read_file con rangos para inspeccionar secciones específicas.
Info rápida
- Autor
- GongRzhe
- Licencia
- MIT
- Runtime
- Python 3.11+
- Transporte
- stdio
- Categoría
- devops
- Dificultad
- Intermedio
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- —
- Versión
- 1.0.0
- Actualizado
- 14 jun 2025
Compatibilidad con clientes
- ❓ Claude Code
- ❓ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Enlaces
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows