Back to Home
bjeans icon

homelab-mcp

Verified Safe

by bjeans

Overview

Provides Model Context Protocol (MCP) servers for managing and monitoring homelab infrastructure through Claude Desktop.

Installation

Run Command
docker exec -i homelab-mcp python homelab_unified_mcp.py

Environment 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

Stats

Interest Score35
Security Score8
Cost ClassMedium
Avg Tokens1500
Stars5
Forks2
Last Update2026-01-17

Tags

HomelabInfrastructure ManagementMonitoringAutomationModel Context Protocol