Homelab Cluster Control

소개

This tool functions as a Model Context Protocol (MCP) server, designed to provide a safe and structured interface for AI agents like Claude to interact with your homelab. It abstracts complex operations into well-defined tools, allowing for secure management of K3s clusters, Pi-hole DNS, Jellyfin, Immich, and Synology NAS resources. With a strong emphasis on defense-in-depth security, it ensures operations are performed within strict, pre-defined boundaries, preventing direct execution of raw commands and minimizing risks.

주요 기능

• Secure AI integration for homelab management via the Model Context Protocol (MCP)
• Robust security model with Kubernetes RBAC, application-layer whitelists, and NAS path validation
• 0 GitHub stars
• Safe action tools for controlled cluster operations like service restarts and backups
• Extensive diagnostic tools for Kubernetes, DNS, media services, and GitOps state
• Integrated Pi-hole DNS management, including query logs and gravity updates

사용 사례

• Allowing an AI assistant (like Claude) to monitor and maintain homelab infrastructure
• Providing a secure, auditable interface for remote homelab diagnostics and troubleshooting
• Automating routine homelab operations such as service restarts, DNS updates, or media metadata refreshes