homelab-mcp
by bshandley
Overview
Provides AI models with remote control capabilities for monitoring and managing homelab infrastructure, including Docker, OPNsense, TrueNAS, Proxmox, and Home Assistant.
Installation
docker compose up -dEnvironment Variables
- CAPABILITY_LEVEL
- API_KEY
- PORT
- SERVER_DOMAIN
- OAUTH_CLIENT_ID
- OAUTH_CLIENT_SECRET
- DOCKER_SOCKET
- DOCKGE_STACKS_PATH
- OPNSENSE_HOST
- OPNSENSE_API_KEY
- OPNSENSE_API_SECRET
- TRUENAS_HOST
- TRUENAS_API_KEY
- PROXMOX_HOST
- PROXMOX_TOKEN_ID
- PROXMOX_TOKEN_SECRET
- HOME_ASSISTANT_HOST
- HOME_ASSISTANT_PORT
- HOME_ASSISTANT_TOKEN
- HOME_ASSISTANT_USE_HTTPS
Security Notes
The server grants AI models direct, high-privilege control over critical infrastructure components (Docker, Proxmox, TrueNAS, OPNsense). The `docker_exec` tool (Level 4) allows arbitrary command execution within containers, a severe security risk. API integrations for Proxmox, TrueNAS, and OPNsense explicitly disable SSL certificate validation (`rejectUnauthorized: false`), making them vulnerable to Man-in-the-Middle attacks if the network is not trusted. While authentication (API Key, OAuth) and capability levels are implemented, the potential for destructive actions or privilege escalation from a compromised AI or misconfigured server is extremely high, as explicitly warned in the README. Hardcoded secrets are not present; environmental variables are used for configuration. No code obfuscation or `eval` usage detected.
Similar Servers
mcpm.sh
MCPM is a command-line tool for managing Model Context Protocol (MCP) servers, enabling discovery, installation, execution, sharing, and integration with various MCP clients.
toolhive-studio
ToolHive is a desktop application (Electron UI) for discovering, deploying, and managing Model Context Protocol (MCP) servers in isolated containers, and connecting them to AI agents and clients.
advanced-homeassistant-mcp
A powerful, secure, and extensible Model Context Protocol (MCP) server that enables AI assistants like Claude, GPT, and Cursor to seamlessly interact with Home Assistant. Control your lights, climate, automations, and more through natural language commands.
openhab-mcp
This project provides an MCP (Model Context Protocol) server to enable AI assistants like Claude and Cline to interact with and manage a real openHAB smart home system via its REST API.