# HomeLab MCP v1.0

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

## Instalación

```bash
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:

```text
/opt/homebrew/bin/uv
```

Argumentos:

```text
--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:

1. `ENABLE_WRITES=true`
2. Recurso en `DOCKER_ALLOWED_CONTAINERS` o `PVE_ALLOWED_VMIDS`
3. Parámetro `confirm` igual a `WRITE_CONFIRMATION`

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

## Docker remoto

Ejemplos:

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

Verifica antes:

```bash
docker -H ssh://root@192.168.3.17 ps
```

## Seguridad

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