homelab-mcp
Verified Safeby bjeans
Overview
Manage and monitor homelab infrastructure components (Docker, DNS, Network, AI, UPS, Ansible) through Claude Desktop.
Installation
docker run -d --name homelab-mcp --network host -v $(pwd)/ansible_hosts.yml:/config/ansible_hosts.yml:ro bjeans/homelab-mcp:latestEnvironment Variables
- ANSIBLE_INVENTORY_PATH
- UNIFI_HOST
- UNIFI_API_KEY
- PIHOLE_API_KEY_SERVER1
- OLLAMA_SERVER1
- LITELLM_HOST
- DOCKER_SERVER1_ENDPOINT
- NUT_USERNAME
- NUT_PASSWORD
Security Notes
The project demonstrates a high commitment to security. It includes automated pre-push Git hooks (`pre_publish_check.py`) to prevent accidental commits of sensitive data (private IPs, API keys, credentials) and provides extensive documentation (`SECURITY.md`, `CLAUDE.md`, `README.md`) on secure configuration, network isolation, and API access best practices. Environment variables are strictly allowlisted (`mcp_config_loader.py`) and recommended over hardcoding. However, it relies on external services (e.g., Docker/Podman APIs, NUT) that may have inherently insecure defaults (unencrypted HTTP, no authentication) if not properly configured with external firewalls or TLS. A 'KNOWN ISSUE' regarding API keys potentially being visible in process lists for `unifi_exporter.py` is acknowledged but is a minor flaw in an otherwise robust security posture. The `network_mode: host` in Docker Compose, while practical for homelabs, increases local network exposure, which is explicitly warned about.
Similar Servers
mcp-manager
A web GUI to easily manage and configure Model Context Protocol (MCP) servers for the Claude Desktop app on MacOS, generating terminal commands for installation and setup.
mcps.nix
A curated library of Model Context Protocol (MCP) server presets for Claude Code, designed to integrate seamlessly with Nix-based configuration management tools like devenv and Home Manager.
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.
vibes
Vibes transforms Claude Desktop into a conversational development environment through distributed MCP servers, allowing users to describe what they want to build and have Claude implement it while teaching them.