HomeLab MCP v1.0

Integra Home Assistant, Frigate, Docker y Proxmox por STDIO.

Instalación

cd /Users/victortg/Projects
mv homelab-mcp homelab-mcp-backup
unzip ~/Downloads/homelab-mcp-v1.0.zip
mv homelab-mcp-v1.0 homelab-mcp
cd homelab-mcp
uv sync

Configuración MCP

Comando:

/opt/homebrew/bin/uv

Argumentos:

--directory
/Users/victortg/Projects/homelab-mcp
run
python
-m
homelab_mcp.server

Copia las variables de .env.example a la configuración del cliente MCP.

Escrituras

Requieren:

ENABLE_WRITES=true
Recurso en DOCKER_ALLOWED_CONTAINERS o PVE_ALLOWED_VMIDS
Parámetro confirm igual a WRITE_CONFIRMATION

Empieza con ENABLE_WRITES=false, prueba las lecturas y luego activa las acciones.

Docker remoto

Ejemplos:

DOCKER_HOST=unix:///var/run/docker.sock
DOCKER_HOST=ssh://root@192.168.3.17

Verifica antes:

docker -H ssh://root@192.168.3.17 ps

Seguridad

No pegues tokens en chats. Revoca cualquier token previamente publicado.