Proxmox MCP Enhanced 🚀

115 Specialized Tools for Comprehensive Proxmox VE Management via Model Context Protocol

Overview

Proxmox MCP Enhanced provides a complete Model Context Protocol (MCP) server implementation for managing Proxmox Virtual Environment (VE) infrastructure. With 115 specialized tools covering every aspect of Proxmox administration, this server enables AI assistants and automation systems to perform complex virtualization tasks seamlessly.

Features

🎯 115 Specialized Tools

• VM Management (9 tools): Create, start, stop, restart, suspend, resume, migrate, clone, delete
• Container Management (9 tools): Full LXC container lifecycle
• Storage Management (10 tools): Create, delete, enable, disable, list, scan, prune, allocate, upload, download
• Cluster Management (8 tools): Node management, quorum, resources
• Monitoring (2 tools): Metrics, alerts, logs, performance
• Backup & Recovery (8 tools): Automated backups, restore, scheduling
• Networking (6 tools): Bridges, bonds, VLANs, DNS configuration
• High Availability (6 tools): HA groups, resource management, failover
• Firewall (5 tools): Rules, groups, aliases, security policies
• User Management (3 tools): Users, groups, roles, permissions, tokens
• API & Resources (1 tool): Task management, resource queries
• Templates (4 tools): VM/container template management
• Migration (3 tools): Live migration, storage migration
• Snapshots (4 tools): Create, restore, manage, delete
• Replication (3 tools): Configure and manage replication
• Ceph Storage (5 tools): Pool creation, OSD management, monitors, status, CRUSH rules
• ZFS Storage (4 tools): Pool creation, dataset management, snapshots, scrubbing
• SDN/VXLAN (4 tools): Software-defined networking zones, virtual networks, subnets
• Automation (3 tools): Create tasks, schedule automation, check status
• Reporting (3 tools): Generate reports, schedule reports, export data
• ISO Management (4 tools) 🆕: Dynamic ISO discovery, download, upload, listing

🔐 Security First

• TypedDict Type Safety: Every parameter strictly typed, no Dict[str, Any]
• Token & Password Authentication: Support for both authentication methods
• SSL/TLS Support: Secure communication with certificate verification
• Permission Management: Fine-grained access control integration

⚡ Modern Architecture

• Async/Await: Full asynchronous operation for optimal performance
• Connection Pooling: Efficient resource management
• MCP Protocol: Native Model Context Protocol implementation
• Modular Design: Clean separation of concerns

Installation

Via pip

pip install proxmox-mcp-enhanced

From source

git clone https://github.com/yourusername/proxmox-mcp-enhanced.git
cd proxmox-mcp-enhanced
pip install -e .

Configuration

Environment Variables

Create a .env file or set these environment variables:

# Required - Host configuration
PROXMOX_HOST=your-proxmox-host.example.com
PROXMOX_USER=root@pam

# Authentication (choose one method)
# Option 1: API Token (recommended)
PROXMOX_TOKEN_NAME=your-token-name
PROXMOX_TOKEN_VALUE=your-token-value

# Option 2: Password
PROXMOX_PASSWORD=your-password

# Optional settings
PROXMOX_PORT=8006              # Default: 8006
PROXMOX_VERIFY_SSL=true        # Default: true

MCP Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "proxmox": {
      "command": "proxmox-mcp",
      "env": {
        "PROXMOX_HOST": "your-host",
        "PROXM

... [View full README on GitHub](https://github.com/chajus1/proxmox-mcp-enhanced#readme)