---
title: Homelab MCP Server
category: Summary
type: Infrastructure/MCP
source_url: https://lobehub.com/mcp/theonlytruebigmac-homelab-mcp
github: https://github.com/theonlytruebigmac/homelab-mcp
date: 2026-02-23
tags: [mcp, homelab, infrastructure, ai, self-hosted]
---

# 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

```bash
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 `*_ENABLED` flag — set to `false` to 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*