HomeLab Monitor · MCP Server

Beschreibung des Anbieters

Self-hosted homelab dashboard with a built-in read-only MCP server (hosts, Docker, GPU, services).

Werkzeuge

list_hosts

List every host in the fleet with headline vitals (hub listed first). Returns the roster: name, online status, OS, CPU/RAM load, fullest disk and any OS-upgrade/reboot hint per host.… Angabe des Anbieters · Beleg 5

get_host

Full System / Network / Security inventory for a single host. `name` is the host's registered name, or "local" for the hub itself. Angabe des Anbieters · Beleg 5

get_snapshot

Current live vitals across the hub: GPU, host RAM/CPU, Docker and systemd health summaries (with any problem containers / failed units), pending OS updates and whether a monitor update is… Angabe des Anbieters · Beleg 5

get_containers

Full Docker container list (Containers tab): per container name, image, state, health, exposed ports, RAM (`mem_bytes`), VRAM (`vram_bytes`), image disk and uptime — plus the summary counts. Angabe des Anbieters · Beleg 5

get_services

Full systemd unit list (Services tab): per unit active/sub state, description, listening ports, RAM, uptime, admin/watched flags and status verdict — plus the summary counts. Angabe des Anbieters · Beleg 5

get_memory

RAM breakdown behind the memory treemap: per-service peak/avg/present RAM over `range`, the current RAM per process right now, kernel (non-reclaimable) memory, and totals.… Angabe des Anbieters · Beleg 5

get_gpu

GPU detail: current utilisation, VRAM used/total, power and temperature, plus per-model VRAM use and the caller→server attribution over `range`.… Angabe des Anbieters · Beleg 5

get_history

Charted time-series the dashboard graphs over `range`: timestamps + aligned arrays for GPU util/VRAM/power/temp and host CPU/RAM/load/temp. Use for trends. Angabe des Anbieters · Beleg 5

scan_disk

WizTree-style nested folder-size treemap for a host path (Disks tab). Wraps the monitor's on-demand scan and polls until done. `path` is an absolute host path (e.g.… Angabe des Anbieters · Beleg 5

get_ai_models

AI model servers: which models are loaded, their VRAM use, and who is driving them (caller→server connection-seconds attribution over `range`, e.g. "6h", "24h", "7d").… Angabe des Anbieters · Beleg 5

get_installed_models

Installed-models registry (#219): every AI model available on the hub — grouped by provider (ollama, vllm, llama.cpp, LM Studio, ComfyUI, …) — not just what's currently loaded.… Angabe des Anbieters · Beleg 5

get_costs

Power-cost summary (Costs tab): what the machine drew and what it cost over `range`, with the live `tariff`, the `machine` totals (now/energy/cost for today, 7d, 30d and the range) and a… Angabe des Anbieters · Beleg 5

get_entity_cost

Cost drill-down for one process/container/service/model by `name` (use a `kind`/`name` pair from `get_costs`' breakdown; `kind` is optional).… Angabe des Anbieters · Beleg 5

get_experiments

Tracked training/eval runs (Experiments tab), each priced with the real GPU energy it burned. Optionally filter by `status` (running/finished/failed/killed).… Angabe des Anbieters · Beleg 5

get_experiment

Full detail for one tracked run by `run_id` (from `get_experiments`): its logged-metric series (the loss curve, and a tokens/sec curve too if logged), the GPU power/util time-series over the… Angabe des Anbieters · Beleg 5

get_benchmarks

LLM Benchmark Lab results (the Benchmarks tab) — stored, rerunnable benchmarks of the host's local models.… Angabe des Anbieters · Beleg 5

get_benchmark

Full detail for one benchmark run by `run_id` (from `get_benchmarks`): every measured point per context size — tokens/sec, load time, VRAM/RAM-offload, fit verdict and which GPU the weights… Angabe des Anbieters · Beleg 5

get_events

Recent edge-triggered events over `range` (OOM kills, threshold crossings), each with a blame line where one can be attributed, plus derived insights. Angabe des Anbieters · Beleg 5

get_uptime

Uptime checks and maintenance windows over `range`, including current state, availability percentage, latency and whether a check is silenced. Angabe des Anbieters · Beleg 5

get_alerts

Alias for `get_events` — the monitor's alerts are its edge-triggered events. Angabe des Anbieters · Beleg 5

Voraussetzungen

• HOMELAB_MONITOR_URL · Umgebungsvariable · erforderlich · Beleg 1
• docker · Paketmanager · erforderlich · Beleg 1
• MCP_TRANSPORT · Umgebungsvariable · optional · Beleg 6
• DB_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 7
• MCP_STATUS_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 7
• HOMELAB_CHANGELOG_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• MCP_ALLOWED_HOSTS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• MCP_ALLOWED_ORIGINS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• MCP_HOST · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• MCP_PORT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• HOMELAB_HTTP_TIMEOUT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8

Installation

docker run docker.io/sikamikaniko123/homelab-monitor:0.14.2 python /app/mcp_server.py

Angaben zum Baustein

—: Angabe nicht belegt.

Maintainer

SikamikanikoBG

Repository-Lizenz

MIT

Letzter Repository-Commit

2026-09-23

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

Ollama

Bereiche

—

Plattformen

—

Version

0.14.2

Release

v0.37.0

Clients

Claude Code, ChatGPT

Repository-Themen

docker, gpu, homelab, monitoring, nvidia, self-hosted, vram, ai-infrastructure, llm, ollama

Homepage

Homepage des Anbieters

Dokumentation

Dokumentation des Anbieters

Zugriffe und Risiken

Regelbasiert abgeleitete Zugriffe

lesen, schreiben

Authentifizierung

—

Transport

stdio

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe. Vor dem Einsatz Konten, Dateien, Netzwerkverbindungen und Ausführungsrechte im konkreten Paket prüfen. Eine frische Änderung am Repository belegt keine Wartung jeder einzelnen Datei.

Nur die für den Arbeitsablauf nötigen Berechtigungen vergeben und Schreibaktionen mit einem Freigabeschritt absichern. Lizenz und Wartungsdatum sind keine Sicherheitsfreigabe.

Der Lizenzbeleg betrifft das Quellcode-Repository. Einzelne Unterpakete und gehostete Dienste können eigene Bedingungen haben; prüfe sie beim konkreten Installations- oder Diensteangebot.