Skip to main content
Glama
BenjaminDuthe

Proxmox MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PROXMOX_HOSTNoProxmox server IP or hostname
PROXMOX_PORTNoAPI port8006
PROXMOX_USERNoUsername (alternative to token)
PROXMOX_TIMEOUTNoRequest timeout (seconds)30
PROXMOX_PASSWORDNoPassword (alternative to token)
PROXMOX_SSH_USERNoSSH usernameroot
PROXMOX_TOKEN_IDNoAPI token ID (user@realm!token)
PROXMOX_VERIFY_SSLNoVerify SSL certificatefalse
PROXMOX_SSH_KEY_PATHNoPath to SSH private key
PROXMOX_TOKEN_SECRETNoAPI token secret (UUID)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_nodesA

Liste tous les nœuds du cluster Proxmox avec leur statut, utilisation CPU/RAM/disque et uptime

get_node_statusA

Récupère les métriques détaillées d'un nœud Proxmox: CPU, RAM, disque, version PVE, kernel

list_vmsA

Liste toutes les VMs QEMU du cluster ou d'un nœud spécifique

get_vm_detailsB

Récupère la configuration complète d'une VM QEMU: CPU, RAM, disques, réseau, statut

start_vmB

Démarre une VM QEMU ou un conteneur LXC

stop_vmA

Arrête de force une VM QEMU ou un conteneur LXC (équivalent à couper l'alimentation)

shutdown_vmB

Arrête proprement une VM QEMU ou conteneur LXC via ACPI/signal shutdown

reboot_vmB

Redémarre une VM QEMU ou conteneur LXC

destroy_vmA

DANGER: Supprime définitivement une VM QEMU ou conteneur LXC et ses disques. Action irréversible!

set_vm_configB

Modifie la configuration d'une VM QEMU (CPU, RAM, nom, etc.)

clone_vmA

Clone une VM ou un template QEMU. Crée une nouvelle VM à partir d'une VM source (template ou VM arrêtée). Supporte le choix du nœud cible et du stockage.

vm_execA

Exécute une commande dans une VM via le QEMU Guest Agent. Retourne un PID à utiliser avec vm_exec_status pour obtenir le résultat.

vm_exec_statusB

Récupère le résultat d'une commande exécutée via guest agent (stdout, stderr, exit code)

vm_exec_syncC

Exécute une commande shell dans une VM et retourne le résultat directement. Supporte les commandes complexes avec arguments, pipes, etc. Nécessite SSH.

vm_file_readC

Lit un fichier dans une VM via le QEMU Guest Agent

vm_file_writeA

Écrit un fichier dans une VM via le QEMU Guest Agent. Certains chemins système (/etc/shadow, /etc/passwd, etc.) sont protégés.

list_containersA

Liste tous les conteneurs LXC du cluster ou d'un nœud spécifique

get_container_detailsA

Récupère la configuration complète d'un conteneur LXC: CPU, RAM, disques, réseau, statut

set_container_configB

Modifie la configuration d'un conteneur LXC (CPU, RAM, swap, hostname, etc.)

pct_execA

Exécute une commande shell dans un conteneur LXC via pct exec. Équivalent de 'pct exec -- '. Nécessite SSH. Supporte les commandes complexes avec pipes, redirections, etc.

list_snapshotsB

Liste les snapshots d'une VM ou conteneur

create_snapshotB

Crée un snapshot d'une VM ou conteneur

delete_snapshotC

Supprime un snapshot d'une VM ou conteneur

rollback_snapshotA

Restaure une VM ou conteneur vers un snapshot. ATTENTION: L'état actuel non sauvegardé sera perdu!

list_storageA

Liste les pools de stockage d'un nœud avec utilisation

get_storage_contentC

Liste le contenu d'un pool de stockage (images, ISOs, backups, etc.)

list_tasksB

Liste les tâches récentes d'un nœud Proxmox

get_task_statusA

Récupère le statut détaillé d'une tâche Proxmox

ssh_executeB

Exécute une commande SSH sur un nœud Proxmox. Permet d'administrer directement le système hôte.

ssh_read_fileB

Lit le contenu d'un fichier sur un nœud Proxmox via SSH

ssh_write_fileA

Écrit un fichier sur un nœud Proxmox via SSH. Crée automatiquement un backup du fichier existant.

fix_apt_reposB

Corrige les dépôts APT Proxmox pour les installations sans souscription. Désactive le dépôt enterprise et active le dépôt community no-subscription.

list_usersA

Liste tous les utilisateurs Proxmox

get_userB

Récupère les détails d'un utilisateur Proxmox

create_userB

Crée un nouvel utilisateur Proxmox

update_userB

Modifie un utilisateur Proxmox existant

delete_userA

Supprime un utilisateur Proxmox. ATTENTION: Action irréversible!

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BenjaminDuthe/proxmox-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server