Proxmox MCP Server

Panoramica

Proxmox MCP Server è un server sviluppato sullo standard Model Context Protocol (MCP) che espone un set esteso di strumenti per la gestione, diagnostica e automazione di ambienti di virtualizzazione basati su Proxmox VE.

Oltre al controllo delle risorse dell'hypervisor (creazione, gestione e ciclo di vita di container LXC e storage), il server integra tool dedicati per Pi-hole v6 (gestione dinamica di record DNS interni) e Nginx Proxy Manager (configurazione di proxy host, regole di routing e certificati SSL). Questa sinergia consente ad agenti AI di gestire in modo completamente autonomo il ciclo di vita dei servizi, dalla clonazione del template fino all'esposizione sicura nella rete locale o pubblica su Internet.

Funzionalità Principali

Orchestrazione Hypervisor Proxmox VE:
- Clonazione di template e creazione container LXC da Debian/Ubuntu con allocazione IP statica e configurazione automatica di CPU, RAM e Storage.
- Gestione snapshot (create, list, rollback), avvio/arresto container ed esecuzione remota di comandi di sistema con monitoraggio dello stato del task.
- Monitoraggio risorse bare-metal (utilizzo CPU, memoria, storage ZFS/LVM e stato salute nodi).
Automazione DNS con Pi-hole v6:
- Aggiunta, eliminazione e sincronizzazione di record DNS A/CNAME personalizzati tramite API REST Pi-hole.
Reverse Proxy con Nginx Proxy Manager:
- Creazione e gestione programmatica di Proxy Host, routing su porte interne e configurazione certificati SSL Let's Encrypt con HTTPS automatico.
Integrazione FastMCP & Python:
- Implementato in Python 3.11+ con il framework FastMCP, gestito tramite il package manager uv per massime prestazioni e facilità di esecuzione via stdio o SSE.

Stato del Progetto

Completamente operativo, impiegato quotidianamente come backend per l'agente AI e per l'automazione dei servizi dell'homelab.