antonio-mello-ai/mcp-proxmox

MCP Developer Tools

An MCP server that lets AI assistants manage Proxmox VE clusters via natural‑language commands

Python Latest v1.2.0 · 2mo ago Security brief →

Features

Provision, start/stop, and clone VMs and containers through conversational prompts
List nodes, resources, snapshots, backups, and firewall rules with simple CLI tools
Execute guest‑agent commands inside QEMU VMs for runtime operations

View all 6 releases →

v1.2.0 New feature 2mo

Notable features

`list_templates` — lists all VM templates available in the cluster for cloning
`create_template` — converts a stopped VM into an irreversible template (requires confirmation)
`configure_cloud_init` — sets user, password, SSH keys, IP configuration, and DNS on a VM

Full changelog

list_templates — List all VM templates available in the cluster for cloning
create_template — Convert a stopped VM into a template (requires confirmation, irreversible)
configure_cloud_init — Set user, password, SSH keys, IP config, and DNS on a VM

uvx mcp-proxmox          # no install needed
pip install mcp-proxmox   # or pip

v1.1.0 New feature 2mo

Notable features

Firewall rule management: list_firewall_rules, add_firewall_rule (full parameters), delete_firewall_rule by position
Live or offline VM/CT migration with migrate_guest tool and confirmation step

Full changelog

list_firewall_rules — List firewall rules for a VM/CT, node, or the cluster
add_firewall_rule — Create firewall rules with full parameter support (action, direction, protocol, port, source/dest CIDR, interface)
delete_firewall_rule — Delete a firewall rule by position (requires confirmation)

migrate_guest — Live or offline migrate a VM/CT to another node (requires confirmation, validates source/target)

All new destructive operations follow the existing two-step confirmation pattern.

uvx mcp-proxmox        # run directly
pip install mcp-proxmox # or install

v0.4.0 New feature 2mo

Notable features

`list_networks` – lists bridges, bonds, and physical interfaces grouped by type
`resize_guest` – resizes CPU, memory, and disk of VMs/containers; auto‑maps `scsi0` → `rootfs` for LXC; irreversible disk resize with confirmation

Full changelog

list_networks — List bridges, bonds, and physical interfaces on a node, grouped by type

resize_guest — Resize CPU, memory, and/or disk of a VM or container
- Auto-maps scsi0 → rootfs for LXC containers
- Disk resize is irreversible (confirmation required)
- Validates disk size format (+10G, 50G, etc.)