fedora-agents
Manage KVM/libvirt VMs and Borg/Timeshift backups on Fedora through 19 MCP tools.
List available tools via
help.Start, stop, destroy, and inspect VM status.
Run commands in a VM over SSH and copy files host↔VM via SCP.
Create, list, restore, or delete VM snapshots; verify cloned VMs.
Clone an existing VM (full or linked) or clone the entire host system into a bootable VM.
Create, list, restore, verify, clean, and monitor backups (timeshift, borg, VM snapshot, manual).
Export VMs to sanitized portable
.tar.gzarchives and import them as new VMs.Use MCP annotations to distinguish read-only vs destructive actions; destructive calls should be confirmed.
Provides backup management for Borg repositories, enabling creation, listing, restoration, integrity verification, retention cleanup, and global backup status.
Manages QEMU/KVM virtual machines through libvirt, providing tools to start, stop, clone, snapshot, destroy, export, import, execute commands, copy files, and verify VMs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fedora-agents show me the status of all VMs and backups"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fedora-agents MCP Server
English summary. MCP server that gives an AI agent hands on KVM/libvirt virtual machines and Borg/Timeshift backups on Fedora. Each tool declares whether it needs sudo and whether it is destructive; the client must confirm destructive calls. Arguments are validated with Zod before any script runs. Install with npx fedora-agents-mcp (--help lists the settings) or npm ci && npm run build. Security policy and tool table: SECURITY.md.
Serveur MCP (Model Context Protocol) qui expose les agents VM-Controller et Backup-Manager via le protocole MCP. Permet a Claude Code de gerer les VMs KVM et les backups directement.
Pourquoi c'est conçu pour des agents LLM
Un script virsh suffit à un humain qui lit la sortie et réagit. Un agent LLM (grand
modèle de langage) qui pilote des machines a besoin d'autres garanties, et c'est ce que
ce serveur ajoute autour des scripts :
Chaque appel est traçable. Un identifiant de corrélation est créé par appel d'outil et suit toutes les lignes du journal ; le journal d'audit JSON est écrit de façon synchrone, sur disque avant la réponse à l'agent (
src/logger.ts).Le réessai dépend de la nature de l'outil. Seules les lectures idempotentes (
vm_status,backup_status,backup_list,backup_verify) sont retentées, trois fois avec un délai croissant de 1, 2 puis 5 s ; une action qui modifie (démarrer, arrêter, restaurer, nettoyer) ne l'est jamais. Une erreur de validation ou de permission arrête tout de suite (src/utils/executor.ts).Le code de sortie devient une erreur typée. Les scripts renvoient un code (délai dépassé, verrou déjà pris, espace insuffisant...) que le serveur traduit en
ErrorCodelisible par l'agent, au lieu d'un texte à interpréter (EXIT_CODE_MAP,src/config.ts).Les droits root sont donnés script par script. Aucune règle sudoers sur
virsh,virt-cloneouqemu-img; seuls les scripts système qui en ont besoin sont autorisés, un par un (voir Emplacement des scripts et sudoers).La progression des tâches longues est publiée. Clone, export ou sauvegarde reportent leurs étapes à mcp-tracking (
scripts/utils/tracking.sh) : l'agent vérifie l'avancement plus tard au lieu de bloquer.Le client sait ce qui est dangereux sans liste à maintenir. Chaque outil publie ses annotations MCP (
readOnlyHint,destructiveHint,idempotentHint) ; Lyra y lit la dangerosité et fait confirmer l'humain avant une action destructrice.
Local-first et self-hosted : tout tourne sur la machine (on-prem), sans service tiers, avec un modèle local via Ollama dans Lyra ou n'importe quel client MCP.
Related MCP server: Linux System MCP Server
Demo

Enregistree sur la machine reelle avec docs/demo/record.sh : un client MCP minimal (docs/demo/mcp_demo.py) demarre le serveur en stdio, liste les outils, appelle help puis vm_status (lecture seule). Les adresses IP sont remplacees par des adresses d'exemple.
Architecture
fedora-agents/
scripts/ -- scripts bash embarques (autonomes, plus de dependance a fedora-setup)
agents/vm-controller/ vm-start, vm-stop, vm-status, vm-exec, vm-copy, vm-snapshot,
vm-destroy, vm-export, vm-import (+ common.sh)
agents/backup-manager/ backup-create, backup-list, backup-restore, backup-verify,
backup-clean, backup-status (+ common.sh)
kvm/ kvm-clone, kvm-clone-system, kvm-snapshot, verify-vm-clone
(+ helpers fix-nm-connection-vm, _fix-grub-vm)
backup/ borg-backup, test-restore, get-borg-passphrase
utils/tracking.sh reporting optionnel vers MCP Tracking (127.0.0.1:8765)
config.env.example surcharges locales (KVM_IMAGES_DIR, VM_SSH_USER...)
src/
index.ts -- point d'entree, enregistrement des outils MCP
config.ts -- timeouts, permissions, codes d'erreur
logger.ts -- logging JSON structure
tools/
vm-controller.ts -- outils vm_start, vm_stop, vm_status, vm_exec, vm_copy,
vm_snapshot, vm_verify, vm_clone, vm_clone_system, vm_destroy
backup-manager.ts -- outils backup_create, backup_list, backup_restore,
backup_verify, backup_clean, backup_status
vm-portability.ts -- outils vm_export, vm_import
vm-hub.ts -- regroupe les outils "hub" ci-dessous (pilotage libvirt direct, sans script) :
vm-lifecycle.ts vm_pause, vm_resume, vm_reboot
vm-create.ts vm_create_from_image
vm-image-fetch.ts vm_image_fetch
vm-console.ts vm_console, vm_console_log
vm-hardware.ts vm_hardware (lecture du materiel)
vm-edit.ts vm_edit (vcpus, memoire, cpu, firmware, TPM, secure boot, demarrage, USB, affichage, reseau, disque)
utils/
executor.ts -- execution des scripts bash avec retry, timeout, gestion erreurs
validation.ts -- schemas Zod pour tous les parametres d'outils
runner.ts -- couture d'execution des outils hub (virsh, virt-xml, qemu-img, xorriso, virt-builder, curl) :
l'executeur reel en production, un faux dans les tests (setRunner)
vm-hub-schemas.ts, vm-images.ts (catalogue interne d'images), vm-domain-xml.ts, cloud-init.ts,
snapshot-current.ts, virsh.ts, vm-hardware-xml.ts (lecture du materiel dans le XML),
vm-edit-plan.ts (plan de commandes de vm_edit) -- schemas et fonctions pures des outils hubOutils MCP exposes
help
Liste tous les outils disponibles avec leurs descriptions.
Script sous-jacent: aucun (genere directement dans index.ts)
VM Controller
Outil | Script sous-jacent | Description |
|
| Demarre une VM, attend optionnellement SSH |
|
| Arrete une VM (proprement ou force) |
|
| Supprime definition + stockage d'une VM |
|
| Affiche l'etat d'une VM (ou liste toutes) |
|
| Execute une commande dans une VM via SSH |
|
| Copie des fichiers hote <-> VM via SCP |
|
| Gere les snapshots (create/list/restore/delete) ; |
|
| Verifie qu'un clone est fidele au systeme hote |
|
| Clone une VM existante (complet ou lie) |
|
| Clone le systeme hote entier vers une VM |
vm_snapshot action list : ligne du snapshot courant
Apres la liste, le serveur interroge virsh snapshot-current --name <vm> et insere, juste avant la ligne Total:, la ligne
Current: <nom-du-snapshot>Aucune ligne si la VM n'a pas de snapshot courant. Le reste de la sortie est inchange : l'analyseur historique de lyra-control-api (parse_snapshots) ignore la ligne (le nom contient un : et un espace), un client qui la connait lit le snapshot courant avec ^Current: (\S+)$. Un nom hors de [A-Za-z0-9][A-Za-z0-9._:-]* n'est pas ecrit (la sortie reste analysable).
VM Hub (pause, redemarrage, creation depuis une image, console)
Ces outils ne passent pas par un script bash : ils pilotent libvirt directement (virsh -c qemu:///system, groupe libvirt, aucun sudo) et rendent un JSON {"ok": true, ...} ou {"ok": false, "code": "...", "error": "..."} (isError positionne sur un echec). Aucune commande n'est construite par interpolation : les arguments sont des tableaux, valides par schema Zod. Toutes les commandes passent par src/utils/runner.ts, ce qui permet de tester sans libvirt.
Outil | Arguments | Effet |
|
|
|
|
|
|
|
| Par defaut une demande ACPI ( |
|
| Cree et definit une VM depuis une image du catalogue (voir ci-dessous) |
|
| Telecharge une image cloud du catalogue dans |
|
| Adresse de la console graphique d'une VM allumee : socket Unix ( |
|
| Dernieres lignes du journal du port serie declare dans le XML de la VM ( |
|
| Lecture seule du materiel declare ( |
|
| Voir ci-dessous. Reponse : |
vm_edit : VM arretee obligatoire pour vcpus, memory_mib, cpu_model, firmware, tpm, secure_boot, disk_grow_gb (refus VALIDATION_ERROR avant toute modification). Tout est valide d'abord (schema, disque reconnu comme volume d'un pool par virsh vol-pool), puis applique champ par champ dans un ordre fixe ; a la premiere erreur l'outil s'arrete et rend applied. Commandes : virsh setvcpus --maximum --config puis --config (les deux ordres sont essayes, libvirt refusant l'un ou l'autre selon le sens du changement), virsh setmaxmem / setmem --config (KiB), virsh autostart [--disable], virsh desc --config --new-desc ; le reste par virt-xml --connect qemu:///system : --edit --cpu <modele>, --edit --boot uefi (secure boot : les anciens <firmware>, <loader> et <nvram> sont effaces puis uefi,loader.secure=yes|no,firmware.feature0.name=secure-boot,firmware.feature0.enabled=yes|no ; le fichier NVRAM existant est conserve, virsh start --reset-nvram si l'invite ne demarre plus), retour au bios en UNE definition : --edit --xml ./os/@firmware= --xml xpath.delete=./os/loader --xml xpath.delete=./os/nvram --xml xpath.delete=./os/firmware --xml xpath.delete=./features/smm (--xml = xpath sur tout le domaine ; l'attribut firmware de <os> est RETIRE, pas mis a bios : Fedora ne livre aucun descripteur SeaBIOS dans /usr/share/qemu/firmware, seulement edk2-ovmf, donc la selection automatique firmware='bios' echoue toujours (« Unable to find 'bios' firmware ») alors qu'un <os> sans attribut demarre SeaBIOS directement ; le <smm state='on'/> pose par libvirt pour le secure boot doit partir dans la meme definition ; xpath.delete=./os/@firmware est a proscrire, il supprime tout <os> ; sans effet (skipped) si la VM est deja en bios ; le fichier NVRAM reste sur le disque), --add-device --tpm default / --remove-device --tpm all, --edit --boot hd,cdrom,network (les <boot order> par peripherique sont effaces d'abord), --edit --graphics <type> ou --add-device --graphics <type>,listen=127.0.0.1, --edit --network network=<nom>, USB : --add-device --hostdev type=usb,source.startupPolicy=optional,xpath... (par identifiant, sans que le peripherique soit branche ; optional : la VM demarre meme s'il est absent, sinon le demarrage echouerait tant qu'il n'est pas detache) / --remove-device --hostdev <rang>. network, usb_attach, usb_detach recoivent --update quand la VM tourne (effet immediat, hot). disk_grow_gb : par libvirt, car le volume appartient a libvirt et l'utilisateur n'a que le groupe (qemu-img resize direct : Permission denied) : virsh vol-pool <chemin> (refus VALIDATION_ERROR si le premier disque fichier n'est le volume d'aucun pool), capacite actuelle par virsh domblkinfo, puis virsh vol-resize <chemin> <capacite + N Gio en octets> --pool <pool> et virsh pool-refresh <pool> ; le systeme de fichiers de l'invite reste a agrandir.
vm_create_from_image selon le format de l'image (fmt du catalogue) :
cloud(image prete qcow2/raw) : copie de l'image dans un volume du pool (vol-create-aspuisvol-upload), agrandissement jusqu'adisk_gb(vol-resize), graine cloud-init (user-data/meta-data-> ISOcidataparxorriso) attachee en lecteur.user(defaut : compte de l'image : debian, fedora, ubuntu, arch, cirros) recoitssh_keyet sudo sans mot de passe. Sansssh_key, la VM est creee mais inaccessible en ssh (avertissement).vb(virt-builder) :virt-builder <modele> --format qcow2 --size <disk_gb>G --hostname ... --ssh-inject root:string:<cle>(+ un compteusersi demande), puis copie du disque dans le pool.ssh_keyest obligatoire.iso: disque qcow2 vide dedisk_gbGo, ISO copiee dans le pool (<nom>-install.iso), demarrage sur le lecteur ;ssh_key,userethostnamesont ignores (avertissement).
Refus avant toute ecriture : nom deja pris (VM ou volume), reseau libvirt inconnu, image absente de VM_IMAGES_DIR, image qcow2 avec fichier de base, disque plus petit que l'image. dry_run fait ces verifications (lectures seules) puis liste les etapes sans rien creer. En cas d'echec en cours de route, les volumes et la VM crees par l'appel sont supprimes (rolled_back). La VM est definie en q35/BIOS, virtio, ecran SPICE sur 127.0.0.1, canal agent invite et port serie journalise dans /var/log/libvirt/qemu/<nom>-serial0.log.
Catalogue d'images (src/utils/vm-images.ts) : 25 identifiants fixes, identiques a lib/vm_library.py de lyra-control-api (cirros, debian-cloud, fedora-cloud, ubuntu-cloud, arch-cloud, vb-debian, vb-fedora, alpine, debian-netinst, fedora-ws, kali...). L'agent ne fournit jamais d'URL ni de chemin. Un fichier en cache se reconnait comme dans l'API : son nom avant le premier point vaut l'identifiant (debian-cloud.qcow2) ou commence par <id>_ (alpine_3.22.iso) ; le tiret n'est pas un separateur. Seules cinq images cloud portent une URL https officielle (cirros 0.6.2, Debian 12 latest, Fedora 43, Ubuntu 24.04 current, Arch latest) ; pour toutes les autres, vm_image_fetch repond « image a placer a la main dans ~/vm-images ».
Prerequis des outils hub, en plus de virsh : qemu-img (lecture de l'image), xorriso (graine cloud-init), virt-builder (guestfs-tools, images vb-*), curl (vm_image_fetch). Reglages :
Variable | Role | Defaut |
| dossier des images (lecture), des fichiers de travail temporaires et des telechargements ; meme variable que l'API |
|
| pool libvirt qui recoit les disques de |
|
| dossiers supplementaires (separes par | aucun |
Pour que vm_console_log lise le journal des VMs creees par l'outil, l'utilisateur doit pouvoir lire /var/log/libvirt/qemu (reserve a root par defaut) : une seule fois, a la main, par exemple sudo setfacl -m u:$USER:rx /var/log/libvirt /var/log/libvirt/qemu && sudo setfacl -d -m u:$USER:r /var/log/libvirt/qemu. Sans cela l'outil repond PERMISSION_DENIED (reason: droits) avec la liste des dossiers autorises ; reason: absent (VALIDATION_ERROR) signifie au contraire que le fichier n'existe pas : VM definie sans <log file> ou jamais demarree. Les VMs creees par vm_create_from_image declarent <serial type='pty'><log file='/var/log/libvirt/qemu/<nom>-serial0.log' append='on'/>... et la <console type='pty'> associee.
Prerequis supplementaire de vm_edit : virt-xml (paquet virt-install).
Backup Manager
Outil | Script sous-jacent | Description |
|
| Dashboard global des backups |
|
| Liste les backups disponibles |
|
| Cree un backup (timeshift/borg/vm-snapshot/manual) |
|
| Verifie l'integrite des backups |
|
| Restaure un backup (destructif) |
|
| Applique les politiques de retention |
VM Portabilite
Outil | Script sous-jacent | Description |
|
| Exporte une VM en archive .tar.gz sanitarisee |
|
| Importe une VM depuis une archive vm_export |
Scripts helpers non exposes
Ces scripts sont utilises en interne mais pas directement accessibles via MCP:
Script | Role |
| Fonctions communes (virsh, SSH, logging) |
| Fonctions communes (borg, locks, notifications) |
| Moteur de snapshots appele par vm-snapshot.sh |
| Corrections post-clone (NetworkManager, grub BLS) |
| Sauvegarde Borg ; passphrase via systemd-creds ou Bitwarden, jamais en clair |
| Test de restauration utilise par backup-verify --deep |
Emplacement des scripts et sudoers
src/config.ts resout la racine des scripts dans cet ordre :
LYRA_SCRIPTS_DIR(variable d'environnement)/usr/local/lib/lyra/scripts: copieroot:root 0755installee par l'installeur Lyrascripts/du depot (mode developpement)
Les outils sans sudo (vm_status, vm_start, vm_stop, vm_exec, vm_copy, vm_snapshot,
vm_export, vm_verify) pilotent libvirt directement : l'utilisateur doit etre membre du groupe
libvirt, que polkit autorise sur qemu:///system :
sudo usermod -aG libvirt "$USER" # puis se reconnecter
virsh -c qemu:///system list --all # doit repondre sans sudoAucune regle sudoers ne vise virsh, virt-clone ou qemu-img : un NOPASSWD sur ces binaires
equivaut a root (un domaine peut monter le disque de l'hote). Les outils qui demandent root
(vm_destroy, vm_clone, vm_clone_system, vm_import et les backup_*) lancent leur script
entier via sudo. Ces regles visent uniquement la copie systeme, script par script, jamais un
glob sur un dossier inscriptible par l'utilisateur (sinon n'importe quel processus de son uid obtient
root en y deposant un .sh) :
user ALL=(ALL) NOPASSWD: /usr/local/lib/lyra/scripts/kvm/kvm-clone.sh
user ALL=(ALL) NOPASSWD: /usr/local/lib/lyra/scripts/kvm/kvm-clone-system.sh
...L'installeur Lyra genere ce fichier (/etc/sudoers.d/lyra) et le valide avec
visudo -cf avant de l'activer. Installation manuelle :
sudo install -d -o root -g root -m 0755 /usr/local/lib/lyra/scripts
sudo cp -r scripts/. /usr/local/lib/lyra/scripts/
sudo chown -R root:root /usr/local/lib/lyra/scripts
sudo find /usr/local/lib/lyra/scripts -type f -name '*.sh' -exec chmod 0755 {} +Configuration
Variable | Rôle | Défaut |
| dossier des scripts (agents/, kvm/) : copie root pour la production, | copie root installée par Lyra, sinon |
| journaux JSON (serveur, erreurs, audit des appels sous sudo ou destructifs) |
|
| chemins KVM, Borg, Timeshift (voir | valeurs d'exemple |
| compte SSH des VMs : par defaut, puis par VM ( | utilisateur courant |
Le serveur est un composant de Lyra mais fonctionne seul : SCRIPTS_DIR=./scripts node dist/index.js démarre sans sudoers (les outils marqués requiresSudo échoueront alors proprement).
Timeouts:
src/config.ts(TIMEOUTS)Permissions sudo:
src/config.ts(TOOL_PERMISSIONS)Retry:
src/config.ts(RETRY_CONFIG)Config locale:
scripts/config.env(copier depuisscripts/config.env.example)
Logs
Les logs JSON structures sont ecrits dans:
/var/log/mcp-agents/(si accessible en ecriture)~/.local/state/mcp-agents/(fallback utilisateur)/tmp/mcp-agents-logs/(fallback final)
Installation en une ligne
npx fedora-agents-mcp # depuis npm ; `npx fedora-agents-mcp --help` pour les reglages
# depuis un clone : npm ci && npm run build && node dist/index.jsConfiguration Claude Desktop / Claude Code (mcpServers) :
{ "fedora-agents": { "command": "npx", "args": ["-y", "fedora-agents-mcp"] } }Politique de securite et tableau des outils : SECURITY.md.
Installation et demarrage
Paquets a installer sur l'hote (noms Fedora ; Debian/Ubuntu entre parentheses quand ils different) :
Commande | Paquet | Outils concernes |
|
| tous les |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Node.js >= 18 |
| le serveur MCP |
Les cles d'hote SSH des VMs sont conservees dans $XDG_STATE_HOME/fedora-agents/known_hosts (a defaut ~/.local/state/fedora-agents/known_hosts) : premier contact accepte, cle modifiee refusee.
npm install
npm run build
# Test local (scripts/ du depot, sans sudoers)
node dist/index.jsLa configuration MCP pour Claude Code ou Claude Desktop est decrite dans la section Installation en une ligne.
Part of the Lyra ecosystem
Dépôt | Rôle |
French-first voice assistant : assistant DevOps vocal, local par défaut (AGPL-3.0) ; le français familier est compris par des règles avant même d'appeler un modèle, ce qui lui suffit d'un modèle de 0.5B | |
MCP : machines virtuelles KVM et sauvegardes | |
MCP + API + tableau de bord des tâches longues | |
hub PWA du homelab | |
MCP Philips Hue (fork de ThomasRohde/hue-mcp) | |
MCP TV Philips | |
MCP ampli Denon | |
MCP Chromecast et DLNA |
Available Tools
19 toolsbackup_cleanADestructive
Applique les politiques de rétention et supprime les anciens backups ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: type (required), force, dry_run, keep_last.
backup_createC
Crée un backup (timeshift, borg, vm-snapshot, ou manual)
Inputs: type (required), vm, dest, live, +6 more.
backup_listBRead-onlyIdempotent
Liste tous les backups disponibles (par type ou tous)
Inputs: all, sort, type, limit, +1 more.
backup_restoreCDestructiveIdempotent
Restaure un backup (ATTENTION: opération destructive!) ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: type (required), identifier (required), force, target, +3 more.
backup_statusBRead-onlyIdempotent
Affiche le dashboard global des backups (status, espace, alertes)
Inputs: watch, compact.
backup_verifyCRead-onlyIdempotent
Vérifie l'intégrité des backups
Inputs: deep, type, quick, backup_id, +1 more.
helpARead-onlyIdempotent
Liste tous les outils disponibles avec leurs descriptions. Appelle cet outil en premier pour savoir ce que tu peux faire.
Inputs: no named parameters.
vm_cloneC
Clone une VM KVM existante (complet ou lié)
Inputs: source_vm (required), new_vm_name (required), start, linked, +4 more.
vm_clone_systemBDestructive
Clone le système hôte entier vers une VM KVM bootable ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: cpus, name, memory, dry_run, +4 more.
vm_copyCDestructiveIdempotent
Copie des fichiers entre l'hôte et une VM via SCP ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: dest (required), source (required), vm_name (required), checksum, +3 more.
vm_destroyADestructiveIdempotent
Supprime complètement une VM KVM (définition + stockage) ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: vm_name (required), force, keep_storage.
vm_execBDestructive
Exécute une commande dans une VM via SSH ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: command (required), vm_name (required), sudo, user, +2 more.
vm_exportA
Exporte une VM KVM dans une archive portable (.tar.gz) avec sanitarisation des donnees sensibles. Mode classic: supprime tous les comptes utilisateurs, passwords, keyrings, cles SSH users. Un script de configuration s'execute au premier demarrage (creation user + password root). Mode exam: conserve les comptes et privileges, sanitarise machine-id/SSH-host-keys/reseau/logs. Mode custom: choisir les operations virt-sysprep via le parametre operations[]. Avec firstboot=true: installe aussi le script de configuration premier demarrage. Effectue un test pre-export (integrite disque, espace) et un test post-export (archive OK). Archive generee: -export-YYYYMMDD-HHMMSS-.tar.gz dans ~/vm-exports/ par defaut.
Inputs: vm_name (required), mode, force, dry_run, +3 more.
vm_importADestructive
Importe une VM KVM depuis une archive exportee par vm_export. Effectue un test pre-import (integrite archive + disque qcow2) et post-import (VM definie + disque OK). Genere un nouveau UUID et une nouvelle adresse MAC automatiquement. Le disque est copie dans /var/lib/libvirt/images/ par defaut. Avec --start: demarre la VM et attend SSH apres l'import. ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: archive_path (required), start, dry_run, new_name, +1 more.
vm_snapshotBDestructive
Gère les snapshots d'une VM (create, list, restore, delete) ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: action (required), vm_name (required), yes, live, +2 more.
vm_startAIdempotent
Démarre une VM KVM et attend optionnellement que SSH soit accessible
Inputs: vm_name (required), timeout, wait_ip, wait_ssh.
vm_statusARead-onlyIdempotent
Affiche le status et les informations d'une VM (IP, SSH, ressources). Sans vm_name, liste toutes les VMs.
Inputs: json, vm_name, detailed.
vm_stopADestructiveIdempotent
Arrête une VM KVM proprement (ou force l'arrêt avec --force) ⚠️ ATTENTION: Opération potentiellement destructive!
Inputs: vm_name (required), wait, force, timeout.
vm_verifyCRead-onlyIdempotent
Vérifie qu'une VM clonée est une copie fidèle du système hôte
Inputs: ip, user, quick, verbose, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a distinct resource and action, with the vm_* and backup_* prefixes clearly separating the two domains. Minor overlap exists between backup_create with vm-snapshot type and vm_snapshot, but the descriptions are clear enough to avoid major confusion.
Tool names mostly follow a consistent resource_action pattern in snake_case, such as vm_start, vm_destroy, backup_create, and backup_restore. Small deviations like vm_snapshot using a noun instead of a verb and the bare `help` tool prevent a perfect score.
With 19 tools, the server is on the heavier side but covers two related domains: VM lifecycle/export and backup management. Each tool earns its place, so the count is reasonable even if slightly above the ideal sweet spot.
The VM workflow is well covered with status, start, stop, destroy, exec, copy, snapshot, clone, verify, export, and import. The backup workflow is also complete with create, list, restore, verify, clean, and status, leaving no obvious dead ends for the stated purpose.
Maintenance
Related MCP Connectors
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Runtime permission, approval, and audit layer for AI agent tool execution.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to perform controlled Linux system administration tasks like reading logs, managing services, cron jobs, WordPress, and executing sandboxed Python code, with strict security constraints.292GPL 2.0
- AlicenseAqualityCmaintenanceEnables AI agents to interact with the Linux desktop through desktop notifications, interactive dialogs, shell command execution, and privileged command execution.15MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to manage Proxmox VMs and LXC containers, host port forwarding, internal dnsmasq DNS, and Caddy sites through natural language, including diff previews and rollback-aware reloads.MIT
- AlicenseBqualityBmaintenanceNido is a local QEMU VM manager. Install it on your computer from https://github.com/Josepavese/nido and run nido mcp via stdio, or use npx -y nido-mcp@latest mcp with QEMU installed locally. It manages VMs on that same computer; a server hosted by Glama cannot access your local VM inventory.62MIT