Add vault content - WORK folder, Tasks, Projects, Summaries, Templates
This commit is contained in:
88
Summaries/Homelab MCP Server.md
Normal file
88
Summaries/Homelab MCP Server.md
Normal file
@@ -0,0 +1,88 @@
|
||||
---
|
||||
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*
|
||||
Reference in New Issue
Block a user