antonio-mello-ai/mcp-proxmox releases

New Tools (3)

• 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

Stats

• 29 tools total (was 26)
• 116 tests passing (was 103)
• Full ruff + mypy strict compliance

Install

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

New Tools (4)

Firewall Rules

• 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)

Live Migration

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

Stats

• 26 tools total (up from 22)
• 103 tests (up from 82)
• 10 new Proxmox API client methods

Safety

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

Install

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

• Docker image now published to GHCR on every release
• docker pull ghcr.io/antonio-mello-ai/mcp-proxmox:latest
• Submitted to Cline Marketplace

v1.0.0 — Production Ready

All 22 tools validated against a real Proxmox VE 9.1.5 cluster with zero failures.

Tools (22 total)

| Category | Tools |
|----------|-------|
| Discovery (5) | list_nodes, get_node_status, list_vms, list_containers, get_guest_status |
| Lifecycle (4) | start_guest, stop_guest, shutdown_guest, reboot_guest |
| Snapshots (4) | list_snapshots, create_snapshot, rollback_snapshot, delete_snapshot |
| Storage (2) | list_storages, list_storage_content |
| Provisioning (4) | create_vm, create_container, clone_guest, delete_guest |
| Backup (3) | list_backups, create_backup, restore_backup |
| Execution (1) | exec_command (QEMU guest agent) |
| Monitoring (2) | get_guest_metrics, list_tasks |
| Network (1) | list_networks |
| Resize (1) | resize_guest (CPU, memory, disk) |

Safety

Destructive operations require explicit confirm=true on a second call. First call returns a warning with impact description.

Install

uvx mcp-proxmox
# or
pip install mcp-proxmox

What's New

Network Tools

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

Resize Tools

• 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.)

Stats

• 22 tools total (was 20 in v0.3.0)
• 82 tests passing
• All 3 sprints complete — ready for v1.0.0 after real-world testing

v0.3.0 — 26 tools: backup, restore, command execution