ProxmoxMCP-Plus
Serveur MCP par RekklesNA
Gérer les machines virtuelles, conteneurs LXC, snapshots, sauvegardes, stockage et l’état du cluster Proxmox VE depuis un assistant IA.
Installer ProxmoxMCP-Plus
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
PROXMOX_MCP_CONFIGfacultatif Optional path to a JSON config file. If set, file config is used before environment variable fallback.PROXMOX_HOSTHostname or IP address of the Proxmox VE API endpoint.PROXMOX_USERProxmox username with realm, for example root@pam.PROXMOX_TOKEN_NAMEName of the Proxmox API token.PROXMOX_TOKEN_VALUEsecret Secret value of the Proxmox API token.PROXMOX_PORTfacultatif Proxmox API port. Defaults to 8006.
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/proxmoxmcp-plusPrésentation
ProxmoxMCP-Plus se connecte à un cluster Proxmox VE via son API et expose les actions de cycle de vie des VM et des LXC, les snapshots, les sauvegardes, la gestion des ISO, l’inspection du stockage et du cluster, la lecture des journaux et le suivi persistant des tâches de longue durée. Il peut aussi exécuter des commandes shell encadrées dans les invités et sur les nœuds.
Il s’exécute en local via stdio avec uvx proxmox-mcp-plus, ou comme serveur Streamable HTTP dans Docker, avec une clé de type bearer obligatoire. L’accès nécessite un jeton API Proxmox (hôte, utilisateur, nom du jeton et valeur du jeton), défini par des variables d’environnement ou un fichier de configuration JSON. Des listes d’autorisation et de refus d’outils permettent de limiter ce qui est exposé.
Ce que vous pouvez faire
- Lister les nœuds, VM, conteneurs, le stockage et l’état du cluster
- Créer, cloner, démarrer, arrêter et supprimer des VM et des conteneurs LXC
- Créer, restaurer à un état antérieur et supprimer des snapshots
- Créer, restaurer et supprimer des sauvegardes
- Exécuter des commandes dans les VM, conteneurs et nœuds
- Suivre, interroger, annuler et relancer des tâches de longue durée
- Lire les journaux syslog, de tâches, du cluster et du pare-feu
Outils 68
list_targetsLister les cibles Proxmox configurées sans exposer les identifiants
get_nodesLister tous les nœuds du cluster
get_node_statusObtenir l’état détaillé d’un nœud
get_node_timeRead node clock and timezone for authentication skew diagnostics
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_vmsLister toutes les machines virtuelles du cluster
preflight_vm_migrationRead-only QEMU migration safety assessment
migrate_vmGuarded offline QEMU VM migration with local disks
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
get_vm_configObtenir la configuration complète d’une VM QEMU
set_vm_descriptionDéfinir la description Notes d’une VM QEMU
Afficher 56 outils de plus
update_vm_configMettre à jour le dimensionnement et les paramètres cloud-init d’une VM
get_vm_ip_addressesObtenir les interfaces réseau et les IP d’une VM via l’agent invité
get_next_vmidObtenir le prochain ID de VM/conteneur libre
create_vmCréer une nouvelle machine virtuelle
clone_vmCloner une machine virtuelle existante
execute_vm_commandExécuter une commande shell dans une VM via QEMU Guest Agent
start_vmDémarrer une machine virtuelle
stop_vmForcer l’arrêt d’une machine virtuelle
shutdown_vmArrêter proprement une machine virtuelle
reset_vmRéinitialiser (redémarrer) une machine virtuelle
delete_vmSupprimer complètement une machine virtuelle
get_storageLister les pools de stockage disponibles
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_cluster_statusObtenir l’état et la santé du cluster
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
list_jobsLister les tâches Proxmox persistantes
get_jobObtenir une tâche persistante par son ID
poll_jobInterroger une tâche pour obtenir son état actuel
cancel_jobDemander l’annulation d’une tâche
retry_jobRelancer une tâche éligible échouée ou annulée
get_containersLister tous les conteneurs LXC
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
start_containerDémarrer des conteneurs LXC
stop_containerArrêter des conteneurs LXC
restart_containerRedémarrer des conteneurs LXC
update_container_resourcesMettre à jour le CPU, la mémoire ou le disque d’un conteneur LXC
create_containerCréer un nouveau conteneur LXC
delete_containerSupprimer des conteneurs LXC
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
execute_container_commandExécuter une commande shell dans un conteneur LXC via SSH
execute_node_commandExécuter une commande shell autorisée sur un nœud via SSH
update_container_ssh_keysMettre à jour le fichier authorized_keys de root dans un conteneur LXC
get_container_configObtenir la configuration complète d’un conteneur LXC
set_container_descriptionDéfinir la description Notes d’un conteneur LXC
get_container_ipObtenir les informations IP actuelles d’un conteneur LXC
list_snapshotsLister les snapshots d’une VM ou d’un conteneur
create_snapshotCréer un nouveau snapshot
delete_snapshotSupprimer un snapshot précis
rollback_snapshotRevenir à un snapshot précis
list_isosLister les images ISO disponibles
list_templatesLister les modèles LXC disponibles
download_isoTélécharger une image ISO
download_templateDownload an LXC template archive to Proxmox storage
delete_isoSupprimer une ISO ou un modèle
list_backupsLister les sauvegardes disponibles
create_backupCréer une sauvegarde d’une VM ou d’un conteneur
restore_backupRestaurer à partir d’une sauvegarde
delete_backupSupprimer une sauvegarde précise
get_node_syslogLire les entrées syslog d’un nœud Proxmox
get_task_logObtenir la sortie du journal d’une tâche Proxmox précise via son UPID
get_cluster_logLire les entrées récentes du journal de l’ensemble du cluster
get_node_firewall_logLire le journal du pare-feu de l’hôte d’un nœud Proxmox
get_guest_firewall_logLire le journal du pare-feu d’une VM (qemu) ou d’un conteneur (lxc)
update_container_networkMettre à jour une interface réseau LXC existante en préservant les paramètres de carte réseau non spécifiés.
list_bridgesLister les bridges Linux/OVS et les VNets SDN autorisés sur un nœud sélectionné.
reconcile_jobRéconcilier une relance incertaine avec un UPID de tâche vérifié ou une confirmation explicite qu’aucune tâche n’a été soumise.
Tirés le 12 oct. 2026 du manifeste du paquet, sans connexion au serveur.
Exemples de prompts
Liste toutes les VM de mon cluster Proxmox et leur état
Crée un snapshot de la VM 102 avant que je la mette à niveau
Montre l’adresse IP du conteneur LXC 205
Sauvegarde le conteneur 110 et dis-moi quand la tâche est terminée
Configuration
Chaque client lance ProxmoxMCP-Plus sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plus- Démarrez Claude Code et tapez
/mcp. proxmoxmcp-plus devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.
Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
VS Code
Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :
{
"servers": {
"proxmoxmcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "${input:proxmox-token-name}",
"PROXMOX_TOKEN_VALUE": "${input:proxmox-token-value}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "proxmox-token-name",
"description": "PROXMOX_TOKEN_NAME",
"password": true
},
{
"type": "promptString",
"id": "proxmox-token-value",
"description": "PROXMOX_TOKEN_VALUE",
"password": true
}
]
}Nécessite uv (Python) sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.
Devin Desktop est le nouveau nom de Windsurf.
Codex
codex mcp add proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plusOu modifiez directement ~/.codex/config.toml :
[mcp_servers.proxmoxmcp-plus]
command = "uvx"
args = ["proxmox-mcp-plus"]
env = { PROXMOX_HOST = "<YOUR_PROXMOX_HOST>", PROXMOX_USER = "<YOUR_PROXMOX_USER>", PROXMOX_TOKEN_NAME = "<YOUR_PROXMOX_TOKEN_NAME>", PROXMOX_TOKEN_VALUE = "<YOUR_PROXMOX_TOKEN_VALUE>" }Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Gemini CLI
gemini mcp add -e "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" -e "PROXMOX_USER=<YOUR_PROXMOX_USER>" -e "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" -e "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" proxmoxmcp-plus uvx proxmox-mcp-plusCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Intégrer
Affichez ProxmoxMCP-Plus dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.
Badge pour README
[](https://mcp.tc/i/proxmoxmcp-plus)<a href="https://mcp.tc/i/proxmoxmcp-plus"><img src="https://mcp.tc/i/proxmoxmcp-plus/badge.svg" alt="ProxmoxMCP-Plus on mcp.tc" height="20"></a>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.
iframe
<iframe src="https://mcp.tc/embed/proxmoxmcp-plus" title="ProxmoxMCP-Plus on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/proxmoxmcp-plus.jsonPrompt pour l’IA
Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de ProxmoxMCP-Plus à votre site.
Ajoute à mon site la carte mcp.tc de ProxmoxMCP-Plus, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.
Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :
```html
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>
```
Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.
```html
<div data-mcptc="proxmoxmcp-plus"><a href="https://mcp.tc/i/proxmoxmcp-plus">ProxmoxMCP-Plus on mcp.tc</a></div>
```
Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.
Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).
Pour un README ou une autre doc en Markdown, utilise plutôt le badge :
```markdown
[](https://mcp.tc/i/proxmoxmcp-plus)
```
Référence : https://mcp.tc/fr/embedHistorique des changements
Nous lisons la liste d’outils du manifeste de bundle de ce serveur sur GitHub toutes les 3 heures et notons ce qui change. Dernière lecture : 18 nov. 2026, 05:30 UTC.
-
Nouvelle version 0.7.1 (avant : 0.7.0). Lue sur PyPI.
-
Nouvelle version 0.7.0 (avant : 0.6.10). Lue sur PyPI.
-
Nouvelle version 0.6.10 (avant : 0.6.9). Lue sur PyPI.
-
Nouvelle version 0.6.9 (avant : 0.6.8). Lue sur PyPI.
-
Nouvelle version 0.6.8 (avant : 0.6.7). Lue sur PyPI.
-
Nouvelle version 0.6.7 (avant : 0.6.6). Lue sur PyPI.
-
Nouvelle version 0.6.6 (avant : 0.6.5). Lue sur PyPI.
-
5 outils ajoutés.
Détails, 19 oct. 2026, 04:36 UTC
Ajoutés 5
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
download_templateDownload an LXC template archive to Proxmox storage
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
migrate_vmGuarded offline QEMU VM migration with local disks
preflight_vm_migrationRead-only QEMU migration safety assessment
-
6 outils ajoutés.
Détails, 18 oct. 2026, 07:33 UTC
Ajoutés 6
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_node_timeRead node clock and timezone for authentication skew diagnostics
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
-
Nouvelle version 0.6.3 (avant : 0.6.2). Lue sur PyPI.
-
Début de l’observation : 57 outils.
FAQ
Puis-je coller mcp.tc/i/proxmoxmcp-plus dans mon client MCP ?
Non. ProxmoxMCP-Plus tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx proxmox-mcp-plus.
ProxmoxMCP-Plus a-t-il besoin d’une clé API ?
Oui. Il lit PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME et PROXMOX_TOKEN_VALUE dans son environnement, et PROXMOX_TOKEN_NAME et PROXMOX_TOKEN_VALUE sont des secrets. Mettez les valeurs dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.
ProxmoxMCP-Plus est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec uvx proxmox-mcp-plus, qui nécessite uv (Python).
Que peut faire ProxmoxMCP-Plus ?
Il a 68 outils, dont list_targets, get_nodes et get_node_status. Vous pouvez lister les nœuds, VM, conteneurs, le stockage et l’état du cluster, créer, cloner, démarrer, arrêter et supprimer des VM et des conteneurs LXC et créer, restaurer à un état antérieur et supprimer des snapshots.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
mcp.tc suit-il les changements de ProxmoxMCP-Plus ?
Oui. Nous suivons la liste d’outils du manifeste de bundle de ProxmoxMCP-Plus, et son onglet Historique montre chaque changement que nous trouvons, ainsi que les nouvelles versions et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de ProxmoxMCP-Plus (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.
mcp.tc n’est pas affilié à RekklesNA. Cette page a été construite à partir des métadonnées publiques de ProxmoxMCP-Plus, vérifiées pour la dernière fois le 12 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.