MCP server for homelab management with Docker, OPNsense, TrueNAS, Proxmox, and Home Assistant integration
Server has 22 tools with consistent naming (verb_noun pattern) and complete input schemas. Descriptions are present but generic, most are 30-80 chars, below the 194-char baseline for A+ tools. Parameters lack depth: no enums for constrained values (e.g., docker_container_logs 'filter' accepts free-form regex; proxmox tools 'type' enum is good but others lack constraints). Output schemas are not documented, LLMs cannot predict response structure. Error handling returns JSON with 'error' and 'message' fields but lacks recovery guidance or error classification. No tool annotations (readOnlyHint/destructiveHint). Security: credentials injected via config (good), but no per-tool permission gates or audit logging visible. Composition is sound, tools are single-purpose and chainable (e.g., docker_list_containers → docker_container_logs). Overall: solid foundation, but descriptions and output documentation need expansion to reach 70+.
Get recent logs from a container
Get CPU/memory/network stats for a container
List all Docker containers with their status
Read the docker-compose.yml for a Dockge stack
Restart a container
Start a stopped container
Stop a running container
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination). Baseline: 100% of A+ tools document return types.
Descriptions too generic and short (avg 50 chars vs 194-char baseline). E.g., 'Get host system information' lacks WHEN to use, WHAT fields are returned, or prerequisites. Baseline: 94% of A+ tools have rich docstrings.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Agents cannot distinguish safe reads from destructive writes without explicit hints. All 8 write tools should be marked destructiveHint=true.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | <=2025-11-25 | v2 |
Get detailed state and attributes of a specific Home Assistant entity
List all Home Assistant entities (lights, switches, sensors, etc.)
Get Home Assistant version, entity count, and available domains
Restart an OPNsense service
Get OPNsense firewall/gateway status
List all Proxmox VMs and containers across all nodes
Reboot a Proxmox VM or container
Gracefully shutdown a Proxmox VM or container
Start a Proxmox VM or container
Get Proxmox cluster status and node information
Stop a Proxmox VM or container (forceful)
Get detailed status of a specific Proxmox VM or container
Get host system information (disk, memory, CPU usage)
Get active TrueNAS alerts
Get TrueNAS pool health and system status
Free-form string parameters lack enums or constraints. E.g., docker_container_logs 'filter' accepts regex but no pattern/enum declared; opnsense_service_restart 'service' is unconstrained. Baseline: constrained inputs prevent hallucinated values.
Error handling lacks recovery guidance. Errors return JSON with 'error' and 'message' but no actionable next steps (e.g., 'Try search_containers() with partial name'). Baseline: errors must guide agent recovery.