Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Homelab Infra MCP

von seayniclabsVersion 2.1.1i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.seayniclabs/homelab-infra-mcp

So installierst du es

Was es kann

Homelab: Nginx Proxy Manager, Docker and Cloudflare DNS, with approval for every change.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Braucht HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN
  • Kategorie Entwicklertools

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

von morluto★ 468.7331 Skills

Skill · Anleitung

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

von multica-ai★ 234.3321 Skills

Skill · AnleitungKeine Lizenz angegeben

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

von Graphify-Labs★ 150.2871 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Homelab Infra MCP. Folge https://mcp.popnx.com/i/seayniclabs-homelab-infra-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Homelab Infra MCP für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "homelab-infra": { "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "your-value", "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value", "HOMELAB_DNS_API_TOKEN": "your-value", "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value", "HOMELAB_UPTIME_API_KEY": "your-value", "HOMELAB_TUNNEL_API_TOKEN": "your-value", "HOMELAB_DNS_FILTER_PASSWORD": "your-value", "HOMELAB_SSO_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Homelab Infra MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei Homelab Infra MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  4. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "homelab-infra": {
          "command": "uvx",
          "args": [
            "homelab-infra-mcp"
          ],
          "env": {
            "HOMELAB_PROXY_PASSWORD": "your-value",
            "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value",
            "HOMELAB_DNS_API_TOKEN": "your-value",
            "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value",
            "HOMELAB_UPTIME_API_KEY": "your-value",
            "HOMELAB_TUNNEL_API_TOKEN": "your-value",
            "HOMELAB_DNS_FILTER_PASSWORD": "your-value",
            "HOMELAB_SSO_TOKEN": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. Claude beenden und neu öffnen

  6. Ausprobieren

    Nutze Homelab Infra MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Homelab Infra MCP nutzt, oder ein Werkzeug von Homelab Infra MCP in der Antwort zeigt, bist du verbunden

19 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • HOMELAB_PROXY_URL Nginx Proxy Manager-Adresse, z. B. http://localhost:81
    Englisches Original anzeigenNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL Nginx Proxy Manager Administrator-E-Mail
    Englisches Original anzeigenNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST Adresse der Docker-Engine, z. B. unix:///var/run/docker.sock
    Englisches Original anzeigenDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL Portainer-Basis-URL, anstelle des Docker-Sockets
    Englisches Original anzeigenPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID Portainer-Endpunkt-ID (Standard 1)
    Englisches Original anzeigenPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID Standard-Cloudflare-Zonen-ID.
    Englisches Original anzeigenDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL Home-Assistant-Adresse (das Modul ist standardmäßig deaktiviert)
    Englisches Original anzeigenHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true aktiviert das Uptime-Kuma-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL Adresse von Uptime Kuma
    Englisches Original anzeigenUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true aktiviert das Cloudflare-Tunnel-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID Cloudflare-Konto-ID, dem der Tunnel gehört
    Englisches Original anzeigenCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID Cloudflare-Tunnel-ID
    Englisches Original anzeigenCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true aktiviert das AdGuard-Home-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL AdGuard-Home-Adresse
    Englisches Original anzeigenAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME AdGuard-Home-Anmeldename
    Englisches Original anzeigenAdGuard Home login
  • HOMELAB_SSO_ENABLED true aktiviert das Authentik-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL Adresse von Authentik
    Englisches Original anzeigenAuthentik address
  • HOMELAB_SSO_FLOW_SLUG Slug des Authentik-Autorisierungsflows für neue Proxy-Provider
    Englisches Original anzeigenAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true verweigert jede Änderung.
    Englisches Original anzeigentrue refuses every change

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Homelab Infra MCP noch nicht verbinden

Homelab Infra MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Homelab Infra MCP verbinden kann

  • Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

B · Andere in Entwicklertools, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Homelab Infra MCP für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD=your-value --env HOMELAB_DOCKER_PORTAINER_TOKEN=your-value --env HOMELAB_DNS_API_TOKEN=your-value --env HOMELAB_HOME_ASSISTANT_TOKEN=your-value --env HOMELAB_UPTIME_API_KEY=your-value --env HOMELAB_TUNNEL_API_TOKEN=your-value --env HOMELAB_DNS_FILTER_PASSWORD=your-value --env HOMELAB_SSO_TOKEN=your-value -- uvx homelab-infra-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Homelab Infra MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei Homelab Infra MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  4. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD=your-value --env HOMELAB_DOCKER_PORTAINER_TOKEN=your-value --env HOMELAB_DNS_API_TOKEN=your-value --env HOMELAB_HOME_ASSISTANT_TOKEN=your-value --env HOMELAB_UPTIME_API_KEY=your-value --env HOMELAB_TUNNEL_API_TOKEN=your-value --env HOMELAB_DNS_FILTER_PASSWORD=your-value --env HOMELAB_SSO_TOKEN=your-value -- uvx homelab-infra-mcp

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. /mcp in Claude Code eingeben

    Homelab Infra MCP sollte in der Liste als verbunden erscheinen

  6. Ausprobieren

    Nutze Homelab Infra MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Homelab Infra MCP nutzt, oder ein Werkzeug von Homelab Infra MCP in der Antwort zeigt, bist du verbunden

19 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • HOMELAB_PROXY_URL Nginx Proxy Manager-Adresse, z. B. http://localhost:81
    Englisches Original anzeigenNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL Nginx Proxy Manager Administrator-E-Mail
    Englisches Original anzeigenNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST Adresse der Docker-Engine, z. B. unix:///var/run/docker.sock
    Englisches Original anzeigenDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL Portainer-Basis-URL, anstelle des Docker-Sockets
    Englisches Original anzeigenPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID Portainer-Endpunkt-ID (Standard 1)
    Englisches Original anzeigenPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID Standard-Cloudflare-Zonen-ID.
    Englisches Original anzeigenDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL Home-Assistant-Adresse (das Modul ist standardmäßig deaktiviert)
    Englisches Original anzeigenHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true aktiviert das Uptime-Kuma-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL Adresse von Uptime Kuma
    Englisches Original anzeigenUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true aktiviert das Cloudflare-Tunnel-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID Cloudflare-Konto-ID, dem der Tunnel gehört
    Englisches Original anzeigenCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID Cloudflare-Tunnel-ID
    Englisches Original anzeigenCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true aktiviert das AdGuard-Home-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL AdGuard-Home-Adresse
    Englisches Original anzeigenAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME AdGuard-Home-Anmeldename
    Englisches Original anzeigenAdGuard Home login
  • HOMELAB_SSO_ENABLED true aktiviert das Authentik-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL Adresse von Authentik
    Englisches Original anzeigenAuthentik address
  • HOMELAB_SSO_FLOW_SLUG Slug des Authentik-Autorisierungsflows für neue Proxy-Provider
    Englisches Original anzeigenAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true verweigert jede Änderung.
    Englisches Original anzeigentrue refuses every change

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Homelab Infra MCP für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "homelab-infra": { "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "your-value", "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value", "HOMELAB_DNS_API_TOKEN": "your-value", "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value", "HOMELAB_UPTIME_API_KEY": "your-value", "HOMELAB_TUNNEL_API_TOKEN": "your-value", "HOMELAB_DNS_FILTER_PASSWORD": "your-value", "HOMELAB_SSO_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Homelab Infra MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei Homelab Infra MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Homelab Infra MCP ist HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in Cursor im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Homelab Infra MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Homelab Infra MCP nutzt, oder ein Werkzeug von Homelab Infra MCP in der Antwort zeigt, bist du verbunden

19 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • HOMELAB_PROXY_URL Nginx Proxy Manager-Adresse, z. B. http://localhost:81
    Englisches Original anzeigenNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL Nginx Proxy Manager Administrator-E-Mail
    Englisches Original anzeigenNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST Adresse der Docker-Engine, z. B. unix:///var/run/docker.sock
    Englisches Original anzeigenDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL Portainer-Basis-URL, anstelle des Docker-Sockets
    Englisches Original anzeigenPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID Portainer-Endpunkt-ID (Standard 1)
    Englisches Original anzeigenPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID Standard-Cloudflare-Zonen-ID.
    Englisches Original anzeigenDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL Home-Assistant-Adresse (das Modul ist standardmäßig deaktiviert)
    Englisches Original anzeigenHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true aktiviert das Uptime-Kuma-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL Adresse von Uptime Kuma
    Englisches Original anzeigenUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true aktiviert das Cloudflare-Tunnel-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID Cloudflare-Konto-ID, dem der Tunnel gehört
    Englisches Original anzeigenCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID Cloudflare-Tunnel-ID
    Englisches Original anzeigenCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true aktiviert das AdGuard-Home-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL AdGuard-Home-Adresse
    Englisches Original anzeigenAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME AdGuard-Home-Anmeldename
    Englisches Original anzeigenAdGuard Home login
  • HOMELAB_SSO_ENABLED true aktiviert das Authentik-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL Adresse von Authentik
    Englisches Original anzeigenAuthentik address
  • HOMELAB_SSO_FLOW_SLUG Slug des Authentik-Autorisierungsflows für neue Proxy-Provider
    Englisches Original anzeigenAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true verweigert jede Änderung.
    Englisches Original anzeigentrue refuses every change

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Homelab Infra MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Homelab Infra MCP für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "homelab-infra": { "type": "stdio", "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_PASSWORD": "your-value", "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value", "HOMELAB_DNS_API_TOKEN": "your-value", "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value", "HOMELAB_UPTIME_API_KEY": "your-value", "HOMELAB_TUNNEL_API_TOKEN": "your-value", "HOMELAB_DNS_FILTER_PASSWORD": "your-value", "HOMELAB_SSO_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Homelab Infra MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei Homelab Infra MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Homelab Infra MCP ist HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in VS Code im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Homelab Infra MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Homelab Infra MCP nutzt, oder ein Werkzeug von Homelab Infra MCP in der Antwort zeigt, bist du verbunden

19 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • HOMELAB_PROXY_URL Nginx Proxy Manager-Adresse, z. B. http://localhost:81
    Englisches Original anzeigenNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL Nginx Proxy Manager Administrator-E-Mail
    Englisches Original anzeigenNginx Proxy Manager admin email
  • HOMELAB_DOCKER_HOST Adresse der Docker-Engine, z. B. unix:///var/run/docker.sock
    Englisches Original anzeigenDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL Portainer-Basis-URL, anstelle des Docker-Sockets
    Englisches Original anzeigenPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID Portainer-Endpunkt-ID (Standard 1)
    Englisches Original anzeigenPortainer endpoint id (default 1)
  • HOMELAB_DNS_ZONE_ID Standard-Cloudflare-Zonen-ID.
    Englisches Original anzeigenDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL Home-Assistant-Adresse (das Modul ist standardmäßig deaktiviert)
    Englisches Original anzeigenHome Assistant address (module is off by default)
  • HOMELAB_UPTIME_ENABLED true aktiviert das Uptime-Kuma-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL Adresse von Uptime Kuma
    Englisches Original anzeigenUptime Kuma address
  • HOMELAB_TUNNEL_ENABLED true aktiviert das Cloudflare-Tunnel-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_ACCOUNT_ID Cloudflare-Konto-ID, dem der Tunnel gehört
    Englisches Original anzeigenCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID Cloudflare-Tunnel-ID
    Englisches Original anzeigenCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED true aktiviert das AdGuard-Home-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL AdGuard-Home-Adresse
    Englisches Original anzeigenAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME AdGuard-Home-Anmeldename
    Englisches Original anzeigenAdGuard Home login
  • HOMELAB_SSO_ENABLED true aktiviert das Authentik-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL Adresse von Authentik
    Englisches Original anzeigenAuthentik address
  • HOMELAB_SSO_FLOW_SLUG Slug des Authentik-Autorisierungsflows für neue Proxy-Provider
    Englisches Original anzeigenAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY true verweigert jede Änderung.
    Englisches Original anzeigentrue refuses every change

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Homelab Infra MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user homelab-infra --env HOMELAB_PROXY_PASSWORD=your-value --env HOMELAB_DOCKER_PORTAINER_TOKEN=your-value --env HOMELAB_DNS_API_TOKEN=your-value --env HOMELAB_HOME_ASSISTANT_TOKEN=your-value --env HOMELAB_UPTIME_API_KEY=your-value --env HOMELAB_TUNNEL_API_TOKEN=your-value --env HOMELAB_DNS_FILTER_PASSWORD=your-value --env HOMELAB_SSO_TOKEN=your-value -- uvx homelab-infra-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "homelab-infra": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "your-value",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value",
        "HOMELAB_DNS_API_TOKEN": "your-value",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value",
        "HOMELAB_UPTIME_API_KEY": "your-value",
        "HOMELAB_TUNNEL_API_TOKEN": "your-value",
        "HOMELAB_DNS_FILTER_PASSWORD": "your-value",
        "HOMELAB_SSO_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "homelab-infra": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "your-value",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value",
        "HOMELAB_DNS_API_TOKEN": "your-value",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value",
        "HOMELAB_UPTIME_API_KEY": "your-value",
        "HOMELAB_TUNNEL_API_TOKEN": "your-value",
        "HOMELAB_DNS_FILTER_PASSWORD": "your-value",
        "HOMELAB_SSO_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "homelab-infra": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ],
      "env": {
        "HOMELAB_PROXY_PASSWORD": "your-value",
        "HOMELAB_DOCKER_PORTAINER_TOKEN": "your-value",
        "HOMELAB_DNS_API_TOKEN": "your-value",
        "HOMELAB_HOME_ASSISTANT_TOKEN": "your-value",
        "HOMELAB_UPTIME_API_KEY": "your-value",
        "HOMELAB_TUNNEL_API_TOKEN": "your-value",
        "HOMELAB_DNS_FILTER_PASSWORD": "your-value",
        "HOMELAB_SSO_TOKEN": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • HOMELAB_PROXY_URL env
    Nginx Proxy Manager-Adresse, z. B. http://localhost:81
    Englisches Original anzeigenNginx Proxy Manager address, e.g. http://localhost:81
  • HOMELAB_PROXY_EMAIL env
    Nginx Proxy Manager Administrator-E-Mail
    Englisches Original anzeigenNginx Proxy Manager admin email
  • HOMELAB_PROXY_PASSWORD geheim erforderlich env
    Nginx Proxy Manager Administrator-Passwort
    Englisches Original anzeigenNginx Proxy Manager admin password
  • HOMELAB_DOCKER_HOST env
    Adresse der Docker-Engine, z. B. unix:///var/run/docker.sock
    Englisches Original anzeigenDocker engine address, e.g. unix:///var/run/docker.sock
  • HOMELAB_DOCKER_PORTAINER_URL env
    Portainer-Basis-URL, anstelle des Docker-Sockets
    Englisches Original anzeigenPortainer base URL, instead of the Docker socket
  • HOMELAB_DOCKER_PORTAINER_TOKEN geheim erforderlich env
    Portainer-API-Schlüssel
    Englisches Original anzeigenPortainer API key
  • HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID env
    Portainer-Endpunkt-ID (Standard 1)
    Englisches Original anzeigenPortainer endpoint id (default 1)
  • HOMELAB_DNS_API_TOKEN geheim erforderlich env
    Cloudflare-API-Token mit Berechtigung zum Bearbeiten von DNS
    Englisches Original anzeigenCloudflare API token with DNS edit permission
  • HOMELAB_DNS_ZONE_ID env
    Standard-Cloudflare-Zonen-ID.
    Englisches Original anzeigenDefault Cloudflare zone id
  • HOMELAB_HOME_ASSISTANT_URL env
    Home-Assistant-Adresse (das Modul ist standardmäßig deaktiviert)
    Englisches Original anzeigenHome Assistant address (module is off by default)
  • HOMELAB_HOME_ASSISTANT_TOKEN geheim erforderlich env
    Langlebiges Zugriffstoken für Home Assistant
    Englisches Original anzeigenHome Assistant long-lived access token
  • HOMELAB_UPTIME_ENABLED env
    true aktiviert das Uptime-Kuma-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Uptime Kuma module (off by default)
  • HOMELAB_UPTIME_URL env
    Adresse von Uptime Kuma
    Englisches Original anzeigenUptime Kuma address
  • HOMELAB_UPTIME_API_KEY geheim erforderlich env
    Uptime-Kuma-API-Schlüssel, gelesen aus /metrics
    Englisches Original anzeigenUptime Kuma API key, read from /metrics
  • HOMELAB_TUNNEL_ENABLED env
    true aktiviert das Cloudflare-Tunnel-Modul (standardmäßig aus)
    Englisches Original anzeigentrue turns on the Cloudflare Tunnel module (off by default)
  • HOMELAB_TUNNEL_API_TOKEN geheim erforderlich env
    Cloudflare-API-Token mit Berechtigung zum Bearbeiten von tunnel
    Englisches Original anzeigenCloudflare API token with tunnel edit permission
  • HOMELAB_TUNNEL_ACCOUNT_ID env
    Cloudflare-Konto-ID, dem der Tunnel gehört
    Englisches Original anzeigenCloudflare account id that owns the tunnel
  • HOMELAB_TUNNEL_TUNNEL_ID env
    Cloudflare-Tunnel-ID
    Englisches Original anzeigenCloudflare Tunnel id
  • HOMELAB_DNS_FILTER_ENABLED env
    true aktiviert das AdGuard-Home-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the AdGuard Home module (off by default)
  • HOMELAB_DNS_FILTER_URL env
    AdGuard-Home-Adresse
    Englisches Original anzeigenAdGuard Home address
  • HOMELAB_DNS_FILTER_USERNAME env
    AdGuard-Home-Anmeldename
    Englisches Original anzeigenAdGuard Home login
  • HOMELAB_DNS_FILTER_PASSWORD geheim erforderlich env
    AdGuard-Home-Passwort
    Englisches Original anzeigenAdGuard Home password
  • HOMELAB_SSO_ENABLED env
    true aktiviert das Authentik-Modul (standardmäßig deaktiviert)
    Englisches Original anzeigentrue turns on the Authentik module (off by default)
  • HOMELAB_SSO_URL env
    Adresse von Authentik
    Englisches Original anzeigenAuthentik address
  • HOMELAB_SSO_TOKEN geheim erforderlich env
    Authentik-API-Token
    Englisches Original anzeigenAuthentik API token
  • HOMELAB_SSO_FLOW_SLUG env
    Slug des Authentik-Autorisierungsflows für neue Proxy-Provider
    Englisches Original anzeigenAuthentik authorization flow slug used for new proxy providers
  • HOMELAB_READ_ONLY env
    true verweigert jede Änderung.
    Englisches Original anzeigentrue refuses every change

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
54/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
2.1.1
In der Registry veröffentlichti
28. Okt. 2026
Code zuletzt geänderti
3. Nov. 2026
Entwickler
seayniclabs
Pakete
pypi: homelab-infra-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto seayniclabs bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 17 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für homelab-infra-mcp@2.1.1

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 16. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/seayniclabs-homelab-infra-mcp.svg)](https://mcp.popnx.com/en/servers/seayniclabs-homelab-infra-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Entwicklertoolsi

  • Mehr Sterne als 0 % der anderen 6209 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 56 % der anderen 6209 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 6209 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Homelab Infra MCP sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: HOMELAB_PROXY_PASSWORD, HOMELAB_DOCKER_PORTAINER_TOKEN, HOMELAB_DNS_API_TOKEN, HOMELAB_HOME_ASSISTANT_TOKEN, HOMELAB_UPTIME_API_KEY, HOMELAB_TUNNEL_API_TOKEN, HOMELAB_DNS_FILTER_PASSWORD, HOMELAB_SSO_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 17 Tagen geändert, und die neueste Version (2.1.1) kam vor 23 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

von ahmedkhaleel2004Weit verbreitet★ 19.004Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · gitdiagram.comVom PopNx-Team ausprobiert

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

von AppllamaWeit verbreitet★ 5233Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · appllama.io

Cloudflare MCP

Cloudflare MCP servers

von cloudflareWeit verbreitet★ 4478Aktualisiert vor 14 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.cloudflare.comVom PopNx-Team ausprobiert

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

von omnara-aiWeit verbreitet★ 3423Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

von repowise-devWeit verbreitet↓ 6506/Wo.★ 8177 Sterne des ganzen ReposAktualisiert vor 7 Tagen

Computer oder Cloud✓ vom Dienst · repowise.dev
Im Vergleich mit ähnlichen
Dieser
Homelab Infra MCP
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem Rechner
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinJaNeinNein
Basisprüfungen3/34/44/44/44/45/5
LizenzMITMITMITApache-2.0Apache-2.0AGPL-3.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Homelab

Made by [Seaynic Labs](https://seayniclabs.com). Need tools like this built around your own systems? We do that.

Homelab is an MCP server that lets an AI assistant manage Nginx Proxy Manager proxy hosts, Docker containers and Cloudflare DNS records from one place. It covers the path from a container to a public web address. One call, expose_service, checks the container, adds the DNS record and the proxy host, and shows the plan before anything changes. Four more optional modules cover Uptime Kuma, Cloudflare Tunnel, AdGuard Home and Authentik.

It is a bundle: one server made of modules, plus skills that teach the assistant the workflows. You switch on the modules you use. New modules arrive switched off, so an update never changes what your assistant can do until you choose to.

Audience: self-hosters running a homelab.

ModuleWhat it doesStatus
proxyNginx Proxy Manager: proxy hosts, redirections, SSL certificates, access listsOn by default
dockerContainers, images and volumes through the local Docker socket or PortainerOn by default
dnsCloudflare DNS zones and records, and BIND exportOn by default
home_assistantEntities, automations, scripts and system info in Home AssistantOff by default, turn on with HOMELAB_HOME_ASSISTANT_ENABLED=true
uptimeUptime Kuma monitors: list and read status (read only)Off by default, turn on with HOMELAB_UPTIME_ENABLED=true
tunnelCloudflare Tunnel routes: list, add and removeOff by default, turn on with HOMELAB_TUNNEL_ENABLED=true
dns_filterAdGuard Home: filter status, query log and filter rulesOff by default, turn on with HOMELAB_DNS_FILTER_ENABLED=true
ssoAuthentik: list applications, create a proxy provider and application for one hostOff by default, turn on with HOMELAB_SSO_ENABLED=true

The core tools are always on: homelab_modules, homelab_health, expose_service, teardown_service, service_status, infrastructure_overview and diagnose_service.

Homelab works with any MCP client: Claude Desktop, Claude Code, Cursor, VS Code, Sonique, Hermes, OpenClaw and others. It runs on your own machine and keeps no data of its own. It talks only to the services you configure.

Install

Homelab needs Python 3.11 or newer. With uv there is nothing to install ahead of time. Pin the version so updates arrive only when you choose them:

uvx homelab-infra-mcp==2.1.1 --version

Or with pip:

pip install homelab-infra-mcp==2.1.1

Upgrading from 2.0? Version 2.1 has no breaking changes. The four new modules are off by default. Read the 2.1.0 section of CHANGELOG.md.

Upgrading from 1.x? Version 2.0 changed the tool names and the environment variable names. Read the migration table in CHANGELOG.md first.

Quick install

Add the server to your MCP client (see Add it to your MCP client), set the variables for the modules you use, and restart the client. Then ask the assistant to call homelab_modules. The response lists each module, whether it is on, and which settings are missing.

Doctor

Run homelab-infra --doctor in a terminal before you start, and after any settings change:

homelab-infra --doctor

The doctor checks each enabled module's settings and reachability, the Docker socket access, and the TLS check. It prints a FIX line for each problem and exits with status 1 when something needs fixing.

Settings

Set these as environment variables in your MCP client's config, or put them in a config file (see below). You only need the settings for the modules you use. Homelab starts without any of them and tells you what is missing when you call a tool.

VariableModuleWhat it is
HOMELAB_PROXY_URLproxyNginx Proxy Manager address. Default http://localhost:81.
HOMELAB_PROXY_EMAIL / HOMELAB_PROXY_PASSWORDproxyThe NPM admin login used for the API
HOMELAB_DOCKER_HOSTdockerDocker engine address. Default unix:///var/run/docker.sock.
HOMELAB_DOCKER_PORTAINER_URL / HOMELAB_DOCKER_PORTAINER_TOKENdockerUse Portainer instead of the socket. Both are needed.
HOMELAB_DOCKER_PORTAINER_ENDPOINT_IDdockerPortainer endpoint id. Default 1.
HOMELAB_DNS_API_TOKENdnsCloudflare API token with DNS edit permission on the zone
HOMELAB_DNS_ZONE_IDdnsDefault zone id, so tools can leave zone_id empty
HOMELAB_HOME_ASSISTANT_URLhome_assistantHome Assistant address. Default http://homeassistant.local:8123.
HOMELAB_HOME_ASSISTANT_TOKENhome_assistantLong-lived access token
HOMELAB_UPTIME_URLuptimeUptime Kuma address
HOMELAB_UPTIME_API_KEYuptimeUptime Kuma API key. Read from /metrics, used for list and get.
HOMELAB_TUNNEL_API_TOKENtunnelCloudflare API token with tunnel edit permission
HOMELAB_TUNNEL_ACCOUNT_IDtunnelCloudflare account id that owns the tunnel
HOMELAB_TUNNEL_TUNNEL_IDtunnelCloudflare Tunnel id
HOMELAB_DNS_FILTER_URLdns_filterAdGuard Home address
HOMELAB_DNS_FILTER_USERNAME / HOMELAB_DNS_FILTER_PASSWORDdns_filterAdGuard Home login
HOMELAB_SSO_URLssoAuthentik address
HOMELAB_SSO_TOKENssoAuthentik API token
HOMELAB_SSO_FLOW_SLUGssoAuthorization flow slug that new proxy providers use
HOMELAB_ _ENABLEDanytrue or false. Turns a module on or off, e.g. HOMELAB_UPTIME_ENABLED=true.
HOMELAB_ _ALLOW_WRITESanyfalse by default: each change asks you first. true lets the assistant make changes in that module without asking. See Safety.
HOMELAB_READ_ONLYalltrue refuses every change, whatever else is set. Reads and dry runs still work.
HOMELAB_ _ _FILEanyRead a secret from a file instead, e.g. HOMELAB_DNS_API_TOKEN_FILE=/run/secrets/cf_token
HOMELAB_CONFIGcorePath to the config file. Default ~/.config/homelab/config.toml.
HOMELAB_APPROVAL_LOGcorePath to the approval log. Default ~/.local/state/homelab/approvals.jsonl, or $XDG_STATE_HOME/homelab/approvals.jsonl when XDG_STATE_HOME is set.

Config file (optional). Homelab also reads ~/.config/homelab/config.toml, or the file named by HOMELAB_CONFIG. Each module has its own table. Environment variables win over the file.

[proxy]

email = "admin@example.com" password = "change-me"

[dns] api_token = "your-cloudflare-token" zone_id = "your-zone-id"

Turn a module on in the same file with its enabled key, or with HOMELAB_ _ENABLED=true in the environment.

Add it to your MCP client

Most clients use the same JSON shape. Pin the version so the server runs the release you tested. Put the block where your client keeps MCP servers:

{

"mcpServers": { "homelab": { "command": "uvx", "args": ["homelab-infra-mcp==2.1.1"], "env": { "HOMELAB_PROXY_EMAIL": "admin@example.com", "HOMELAB_PROXY_PASSWORD": "change-me", "HOMELAB_DNS_API_TOKEN": "your-cloudflare-token", "HOMELAB_DNS_ZONE_ID": "your-zone-id" } } } }

ClientWhere the config goes
Claude Desktopclaude_desktop_config.json (Settings → Developer → Edit Config)
Claude Codeclaude mcp add homelab -- uvx homelab-infra-mcp==2.1.1, then add the env values, or a project .mcp.json
Cursor~/.cursor/mcp.json, or .cursor/mcp.json in a project
VS Code.vscode/mcp.json, using "servers" instead of "mcpServers"
Sonique, Hermes, OpenClaw, othersAny client that launches a stdio MCP server: command uvx, args ["homelab-infra-mcp==2.1.1"], plus the env values

As a Claude Code plugin. The plugin installs the server and the skills together. Its .mcp.json pins homelab-infra-mcp==2.1.1. Set the variables in your environment or in the config file.

Over HTTP. For clients that connect to a URL instead of launching a process:

homelab-infra --transport http --port 8200

It serves streamable HTTP at http://127.0.0.1:8200/mcp. It listens only on your own machine by default. Put authentication in front of it before exposing it anywhere else.

Tools

The default install has 16 tools. Each module adds its own tools when you turn it on.

ToolWhat it does
homelab_modulesWhich modules are on, which settings are missing, and what each tool does. Call this first.
homelab_healthConnectivity and version for every enabled module
expose_serviceCheck a container, add a DNS record (optional), add a proxy host. One approved plan.
teardown_serviceRemove a service's proxy host and optional DNS record. One approved plan.
service_statusOne view of a service: container, proxy hosts, DNS records
infrastructure_overviewCounts across Docker, the proxy and DNS
diagnose_serviceRead only. Checks each hop from a domain to its service, one row per hop. Returns the first failing hop and its fix.
proxy_hostslist, get, create, update, delete proxy hosts
proxy_redirectionslist, create, delete HTTP redirections
proxy_certificateslist, request a Let's Encrypt certificate
proxy_access_listslist, create, delete IP access lists
docker_containerslist, get, start, stop, restart, remove, logs, stats, prune
docker_imageslist, pull, remove, prune
docker_inventoryvolumes, networks, or Portainer stacks (with a stack's compose file)
dns_zoneslist zones, or export one in BIND format
dns_recordslist, get, create, update, delete records
ha_entitieslist, get, search; call_service, turn_on, turn_off, toggle (Home Assistant)
ha_automationslist, trigger, reload automations or scripts; create previews automation YAML (Home Assistant)
ha_systemConfig, available services, check_config (Home Assistant)
uptime_monitorslist, get: read only (Uptime Kuma). Pause and resume are not in 2.1.
tunnel_routeslist; add, remove need approval (Cloudflare Tunnel)
dns_filter_statusFilter status and query and block totals (AdGuard Home, read only)
dns_filter_queriesPaged query log (AdGuard Home, read only)
dns_filter_ruleslist blocked services and custom rules; add, remove need approval (AdGuard Home)
sso_applicationslist; create makes a proxy provider and an application for one host, and needs approval (Authentik)

Every tool returns structured data with a published schema, so an assistant can write code against the results. Lists take limit and offset. Every change tool takes dry_run=true, which shows exactly what would change and changes nothing. Errors always look like homelab. . : Fix: .

Skills

Skills are short guides the assistant reads before a job. Homelab ships them in a skills/ folder for apps that read Agent Skills, and serves each one as an MCP prompt for every other client.

Written for Homelab

SkillWhat it covers
getting-startedWhich modules are on, the settings each needs, the first checks, how approvals work
expose-a-service-safelyPut one container on a public name: dry run, approval, per-hop diagnosis, outside check
homelab-health-checkA read-only sweep of modules, containers, certificates, monitors and DNS filtering
homelab-troubleshootingRoot-cause investigation for a failing service, one hypothesis at a time
fix-and-deploy

Nur der Anfang wird gezeigt; den Rest findest du im Repo