fedora-agents
Servidor MCP en TypeScript para gestión de máquinas virtuales KVM/libvirt y copias de seguridad Borg/Timeshift en entornos Fedora. Ejecuta scripts locales con validación Zod y control estricto de permisos sudo.
Ficha actualizada 24 sept 2026, 1:50 · upstream 24 sept 2026, 1:33 · release v1.2.2
Qué es fedora-agents
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este servidor MCP, escrito en TypeScript, expone herramientas para agentes de IA que gestionan infraestructura virtual KVM/libvirt y copias de seguridad Borg/Timeshift en sistemas Fedora. Permite operaciones completas como arranque, detención, clonación de máquinas virtuales, ejecución remota de comandos vía SSH y gestión de snapshots.
Integra la gestión de copias de seguridad mediante Borg y Timeshift, incluyendo creación, verificación de integridad y restauración. El servidor valida todos los argumentos con esquemas Zod antes de ejecutar cualquier script bash embebido, asegurando que las operaciones destructivas requieran confirmación explícita del cliente MCP.
La arquitectura separa scripts de gestión (vm-controller, backup-manager) de utilidades internas, permitiendo despliegues locales o integrados en el ecosistema Lyra. Los logs se estructuran en JSON para facilitar la trazabilidad y depuración.
- Gestión automatizada de máquinas virtuales KVM desde un agente de IA (Claude Code/Desktop)
- Automatización de copias de seguridad periódicas con verificación de integridad mediante Borg
- Clonación de sistemas virtuales con corrección automática de configuración de red y GRUB
- Auditoría de estado de infraestructura virtual sin acceso directo a la consola
- Ejecución remota de comandos en entornos aislados con validación de parámetros
- Scripts bash embebidos independientes del entorno Fedora para mayor portabilidad
- Validación estricta de esquemas Zod para todos los parámetros de las herramientas MCP
- Control granular de permisos sudo por script específico en lugar de acceso root global
- Soporte nativo para protocolo MCP (stdio) compatible con Claude Code y Desktop
- Logs estructurados en JSON para trazabilidad detallada de operaciones
- Requiere configuración manual de sudoers específica para scripts de clonación y destrucción
- Depende de binarios externos como virsh, qemu-img y borg instalados previamente en el host
- No incluye contenedorización (Docker/Podman) nativa para aislamiento del servidor
- Necesita que el usuario pertenezca al grupo libvirt para acceso a QEMU sin sudo
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar Node.js >= 18 y paquetes virtuales (libvirt-client, qemu-utils, borgbackup). Copiar scripts a directorio seguro o ejecutar localmente. Configurar sudoers con NOPASSWD solo para rutas específicas de scripts Lyra. Añadir usuario al grupo libvirt. Verificar permisos en /usr/local/lib/lyra/scripts.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.