89 lines
2.7 KiB
Markdown
89 lines
2.7 KiB
Markdown
---
|
|
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*
|