2.7 KiB
2.7 KiB
title, category, type, source_url, github, date, tags
| title | category | type | source_url | github | date | tags | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Homelab MCP Server | Summary | Infrastructure/MCP | https://lobehub.com/mcp/theonlytruebigmac-homelab-mcp | https://github.com/theonlytruebigmac/homelab-mcp | 2026-02-23 |
|
Homelab MCP Server
URL: https://lobehub.com/mcp/theonlytruebigmac-homelab-mcp GitHub: https://github.com/theonlytruebigmac/homelab-mcp Date Summarized: 2026-02-23
tl;dr
A unified MCP (Model Context Protocol) server that connects AI agents to your self-hosted homelab infrastructure through 30+ consolidated tools.
What it is
- MCP Server for homelab infrastructure
- Connects AI assistants (Claude, Gemini, ChatGPT, Cursor) to your self-hosted services
- Also exposes a full REST API for automation tools like n8n
Key Features
- 30 consolidated MCP tools — action-based compound tools for efficient context windows
- MCP Resources — real-time data feeds (clients, devices, queues, health)
- MCP Prompts — pre-built templates for troubleshooting, security audits, health checks
- REST API — every tool exposed as REST endpoint with Swagger docs
- Conditional registration — only enabled services register their tools
- Docker-first deployment — single
docker compose up - Audit logging — every tool call traced and logged
Supported Services (9 total)
| Service | Category | Tools | Capabilities |
|---|---|---|---|
| Unifi | Networking | 9 | Clients, devices, firewall, VLANs, security, guest access |
| Proxmox | Virtualization | 3 | VMs, containers, snapshots, storage, power mgmt |
| Plex | Media Server | 2 | Playback, library search, scans, stream control |
| Radarr/Sonarr | Media Mgmt | 4 | Movie/TV search, add content, calendar, queue |
| SABnzbd | Downloads | 2 | Queue management, speed limits, history |
| Portainer | Docker | 4 | Containers, stacks, volumes, logs |
| OPNsense | Firewall | 2 | Interfaces, DHCP, gateway, firmware |
| Home Assistant | IoT/Smart Home | 3 | Entities, automations, scenes, service calls |
| Traefik | Reverse Proxy | 1 | Router inspection, backends, health |
Tech Stack
- Python 3.11+
- Docker/Docker Compose
- MCP 2.0+
- MIT License
Quick Install
git clone https://github.com/theonlytruebigmac/homelab-mcp.git
cd homelab-mcp
cp .env.example .env
# Edit .env with your service credentials
docker compose up
Notes
- Each service has an
*_ENABLEDflag — set tofalseto disable - Supports both MCP protocol and REST API
- Designed for AI agents to directly manage homelab infrastructure
Summarized from lobehub.com/mcp/theonlytruebigmac-homelab-mcp