ProxmoxMCP Plus

# ProxmoxMCP-Plus

An enhanced Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platforms. This project extends [canvrno/ProxmoxMCP](https://github.com/canvrno/ProxmoxMCP) with additional features including complete OpenAPI integration and expanded virtualization management capabilities.

## Acknowledgments

This project is built upon the open-source project [ProxmoxMCP](https://github.com/canvrno/ProxmoxMCP) by [@canvrno](https://github.com/canvrno).

- 🐳 **New Container Support**
  - `get_containers` - List all LXC containers and their status
  - `get_container_config` - Get full configuration of an LXC container
  - `get_container_ip` - Get current IP address(es) of a running LXC container
  - `start_container` - Start LXC container
  - `stop_container` - Stop LXC container
  - `restart_container` - Restart LXC container (forcefully/gracefully)
  - `update_container_resources` - Adjust container CPU, memory, swap, or extend disk
  - `execute_container_command` - Run shell commands inside a running LXC container via SSH + `pct exec` (no guest agent required; [see setup guide](docs/container-command-execution.md))
  - `update_container_ssh_keys` - Inject or replace SSH authorized_keys for root in an LXC container (requires SSH; [see setup guide](docs/container-command-execution.md))
## New Features and Improvements

### Major Enhancements

| Feature Category | Description | Tools |
|-----------------|-------------|-------|
| **VM Lifecycle Management** | Complete virtual machine creation, management, and deletion | `create_vm`, `delete_vm` |
| **Power Management** | Control VM power states | `start_vm`, `stop_vm`, `shutdown_vm`, `reset_vm` |
| **Container Support** | Full LXC container lifecycle management | `get_containers`, `get_container_config`, `get_container_ip`, `create_container`, `delete_container`, `start_container`, `stop_container`, `restart_container`, `update_container_resources`, `execute_container_command`, `update_container_ssh_keys` |
| **Snapshot Management** | Create and manage VM/container snapshots | `list_snapshots`, `create_snapshot`, `delete_snapshot`, `rollback_snapshot` |
| **Backup and Restore** | Backup and restore VMs and containers | `list_backups`, `create_backup`, `restore_backup`, `delete_backup` |
| **ISO and Template Management** | Manage installation media and templates | `list_isos`, `list_templates`, `download_iso`, `delete_iso` |
| **Monitoring** | Cluster and resource monitoring | `get_nodes`, `get_node_status`, `get_vms`, `get_storage`, `get_cluster_status` |
| **OpenAPI Integration** | REST API endpoints for external integration | 20+ API endpoints |
| **Security and Stability** | Production-grade error handling and validation | Token-based authentication, comprehensive logging |

## Built With

- [Proxmoxer](https://github.com/proxmoxer/proxmoxer) - Python wrapper for Proxmox API
- [MCP SDK](https://github.com/modelcontextprotocol/sdk) - Model Context Protoc

... [View full README on GitHub]