Homelab MCP Server

Serveur MCP extensible pour gérer votre homelab directement depuis Claude AI. Contrôlez vos VMs, snapshots, services et fichiers en langage naturel.

Proxmox VE est entièrement supporté · VMware, Docker et d'autres plateformes sont prévus.

⚡ Installation en 3 étapes

1. Téléchargez le docker-compose.yml

curl -O https://raw.githubusercontent.com/faton5/homelab-mcp-server/master/docker-compose.yml

2. Remplissez vos 4 valeurs

Ouvrez docker-compose.yml et modifiez uniquement les lignes marquées ✏️ :

- PROXMOX_HOST=192.168.1.10          # ✏️ IP de votre Proxmox
- PROXMOX_PORT=8006                   # ✏️ Port (8006 par défaut)
- PROXMOX_TOKEN_ID=root@pam!mcp       # ✏️ Token ID
- PROXMOX_TOKEN_SECRET=xxxx-xxxx      # ✏️ Secret du token

Créer un token Proxmox : Datacenter → API Tokens → Add

3. Lancez le serveur

docker compose up -d

L'image est téléchargée automatiquement depuis GitHub Container Registry. ✅

Related MCP server: vlp-mcp-agent

🔌 Connecter Claude

Ajoutez ceci à votre config Claude Desktop (~/.config/claude/claude_desktop_config.json) :

{
  "mcpServers": {
    "homelab": {
      "url": "http://VOTRE_IP_DOCKER:10850/sse"
    }
  }
}

Remplacez VOTRE_IP_DOCKER par l'IP du serveur qui fait tourner Docker, puis redémarrez Claude (Ctrl+R).

Claude Code

claude mcp add homelab http://VOTRE_IP_DOCKER:10850/sse

Codeium / Gemini / autres

URL SSE : http://VOTRE_IP_DOCKER:10850/sse

🛠️ Outils disponibles (32)

⚠️ = demande une confirmation explicite avant exécution

💬 Exemples d'utilisation

"Liste toutes mes VMs Proxmox"
"Quel est le statut de HLB-VPN-01 ?"
"Crée un snapshot de HLB-NAS-01 nommé avant-migration"
"Augmente la RAM de HLB-DOCKER-01 à 8 Go"
"Montre les 20 processus qui consomment le plus de RAM sur HLB-NC-01"
"Redémarre le service nginx sur HLB-HA-01"
"Liste les backups disponibles sur le node PROXMOX"

🔍 Dépannage

VMs non détectées → Vérifiez l'IP Proxmox et les permissions du token API.

Exécution de commandes impossible → Installez qemu-guest-agent dans vos VMs.

MCP non visible dans Claude → Vérifiez que le container tourne (docker ps), puis redémarrez Claude (Ctrl+R).

Logs du serveur :

docker logs infra-manager-mcp

🤝 Contribuer

Pull requests et issues bienvenus ! Priorités : support VMware, Docker, équipements réseau.

📄 Licence

MIT — voir LICENSE

Built with MCP · Powered by proxmoxer · For Claude AI