homelab-mcp
Verified Safeby bjeans
Overview
Provides Model Context Protocol (MCP) servers for managing and monitoring homelab infrastructure through Claude Desktop.
Installation
docker exec -i homelab-mcp python homelab_unified_mcp.pyEnvironment Variables
- ANSIBLE_INVENTORY_PATH
- DOCKER_SERVER1_ENDPOINT
- PODMAN_SERVER1_ENDPOINT
- PING_TARGET1
- PING_TARGET1_NAME
- OLLAMA_PORT
- OLLAMA_SERVER1
- LITELLM_HOST
- LITELLM_PORT
- PIHOLE_DELL_HOST
- PIHOLE_DELL_PORT
- PIHOLE_API_KEY_DELL
- UNIFI_HOST
- UNIFI_API_KEY
- NUT_PORT
- NUT_USERNAME
- NUT_PASSWORD
Security Notes
The project demonstrates a strong focus on security, with automated pre-push checks (e.g., `pre_publish_check.py`), `.env` file protection, and explicit warnings about inherent risks of managed services (e.g., unencrypted Docker APIs, needing firewall rules). Logging includes sensitive data sanitization. A `write_mcp_file` tool exists (deprecated) with path validation to prevent directory traversal. The main security risks stem from improper configuration of underlying homelab services (e.g., exposing Docker APIs to the internet) rather than direct vulnerabilities in the MCP server code itself. The project transparently documents these risks and provides comprehensive mitigation guidance.
Similar Servers
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.
datadog-mcp
Provides Datadog monitoring and management capabilities as a Model Context Protocol (MCP) server for Claude Desktop and other MCP clients.
miyabi-mcp-bundle
An all-in-one MCP server providing a vast array of development, monitoring, and automation tools, enabling Claude Desktop and AI agents to perform complex software development, operations, and analysis tasks efficiently and securely.
homelab-mcp-server
Manages Docker containers and compose projects in a homelab environment via an MCP client like Claude.