Back to Home
myraffy icon

homelab-mcp

Verified Safe

by 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

Run Command
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:latest

Environment 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

Stats

Interest Score0
Security Score6
Cost ClassMedium
Avg Tokens500
Stars0
Forks0
Last Update2026-01-19

Tags

HomelabMonitoringInfrastructureAutomationMCP