homelab-mcp
Verified Safeby myraffy
Overview
Manage and monitor homelab infrastructure including Docker/Podman, Ollama AI, Pi-hole DNS, Unifi networks, Ansible inventory, and UPS systems through an MCP-compatible server.
Installation
docker build -t homelab-mcp:latest . && docker run -d --name homelab-mcp --network host -e ANSIBLE_INVENTORY_PATH=/config/ansible_hosts.yml -v $(pwd)/ansible_hosts.yml:/config/ansible_hosts.yml:ro --stdin --tty --cap-add=NET_RAW homelab-mcp:latestEnvironment Variables
- ANSIBLE_INVENTORY_PATH
- DOCKER_SERVER*_ENDPOINT
- PODMAN_SERVER*_ENDPOINT
- OLLAMA_PORT
- OLLAMA_SERVER*
- LITELLM_HOST
- LITELLM_PORT
- PIHOLE_*_HOST
- PIHOLE_API_KEY_*
- UNIFI_HOST
- UNIFI_API_KEY
- PING_TARGET*
- NUT_PORT
- NUT_USERNAME
- NUT_PASSWORD
Security Notes
The project demonstrates strong security awareness through comprehensive documentation (SECURITY.md, pre_publish_check.py) and a pre-push Git hook to prevent accidental exposure of sensitive data. It explicitly warns about the inherent security risks of some services (e.g., Docker/Podman APIs often using unencrypted HTTP without authentication) and provides mitigation strategies like firewall rules and TLS. However, some key services, such as the Unifi exporter, by default disable SSL verification for HTTPS connections (`verify_ssl=False`, `urllib3.disable_warnings`), which is a significant security vulnerability to Man-in-the-Middle attacks. Other integrations primarily use unencrypted HTTP, relying on network isolation for security. While risks are acknowledged and documented, the default insecure network settings for Unifi are a notable concern.
Similar Servers
llms
A centralized configuration and documentation management system for LLMs, providing tools for building skills, commands, agents, prompts, and managing MCP servers across multiple LLM providers.
homelab-mcp
Provides Model Context Protocol (MCP) servers for managing and monitoring homelab infrastructure through Claude Desktop.
full-stack-proxy-nginx-n8n-for-everyone-with-docker-compose
A comprehensive Docker Compose setup for deploying a full-stack development environment including Nginx as a reverse proxy, n8n for workflow automation, Ollama and Open WebUI for local AI, PostgreSQL with pgvector for data storage, Mailhog for email testing, WAHA for WhatsApp integration, and Portainer for container management, with automated SSL certificates.
systems-manager
This project provides a multi-OS system management CLI and an MCP server for automating system maintenance, application management, and configuration via AI or automation systems.