Human-in-the-Loop MCP Server
by GongRzhe
Permite a los asistentes de IA solicitar entrada humana mediante diálogos GUI nativos
productivity Python Principiante Auto-hospedable Sin API key
⭐ 145 stars 📅 Actualizado: hace 9m
Descripción
Un servidor MCP que conecta la automatización de IA con la toma de decisiones humana proporcionando herramientas de diálogo GUI en tiempo real. Los asistentes de IA pueden solicitar entrada de texto, presentar opciones, recoger feedback multilínea, mostrar confirmaciones y notificaciones a través de diálogos nativos del SO. Multiplataforma con tiempo de respuesta inferior a 100ms, operaciones no bloqueantes en hilos separados y timeouts configurables de 5 minutos.
✅ Ideal para
Flujos de trabajo de IA que necesitan supervisión, aprobación o entrada humana en puntos de decisión críticos
⏭️ No recomendado si
Estás ejecutando en un entorno de servidor headless o necesitas interacción basada en web
💡 Casos de uso
- Obtener confirmación humana antes de que la IA ejecute acciones críticas
- Recoger entrada del usuario durante el flujo de trabajo para decisiones o parámetros
- Presentar opciones de selección múltiple para elección humana
- Mostrar notificaciones de estado y resultados de operaciones
- Recopilar feedback detallado o código vía diálogos multilínea
👍 Ventajas
- ✓ GUI nativa multiplataforma (Windows, macOS, Linux)
- ✓ No bloqueante con inicialización de diálogos en menos de 100ms
- ✓ Sin API key ni servicio externo requerido
- ✓ Interfaz limpia de 6 herramientas para todos los patrones de interacción comunes
👎 Desventajas
- ✗ Requiere entorno de escritorio — sin soporte headless/servidor
- ✗ Las dependencias del toolkit GUI pueden necesitar instalación en algunas distros Linux
- ✗ El timeout de 5 minutos puede ser insuficiente para decisiones complejas
🔧 Herramientas expuestas (6 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| show_confirmation_dialog | confirmation | Solicitar confirmación sí/no antes de proceder con acciones |
| get_user_input | input | Obtener texto, números o datos de una línea con validación opcional |
| get_user_choice | input | Presentar opciones de selección múltiple con soporte de selección simple o múltiple |
| get_multiline_input | input | Recoger contenido de texto extenso para código, descripciones o feedback |
| show_info_message | notification | Mostrar notificaciones, actualizaciones de estado y resultados de operaciones |
| health_check | system | Monitorear estado del servidor y disponibilidad de la GUI |
💡 Consejos y trucos
Usa show_confirmation_dialog antes de operaciones destructivas. Combina get_user_choice para selecciones rápidas y get_multiline_input para feedback detallado.
Info rápida
- Autor
- GongRzhe
- Licencia
- MIT
- Runtime
- Python 3.10+
- Transporte
- stdio
- Categoría
- productivity
- Dificultad
- Principiante
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- —
- Versión
- 1.0.0
- Actualizado
- 18 jun 2025
Compatibilidad con clientes
- ❓ Claude Code
- ❓ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Enlaces
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows