Homelab Infra MCP Server

What the code does

We read the source, 21 h ago · rules 995398eba69f

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

DEFAULT_DOCKER = "unix:///var/run/docker.sock"

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add homelab-infra-mcp -- uvx homelab-infra-mcp

{
  "mcpServers": {
    "homelab-infra-mcp": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ]
    }
  }
}

[mcp_servers.homelab-infra-mcp]
command = "uvx"
args = ["homelab-infra-mcp"]

{
  "mcpServers": {
    "homelab-infra-mcp": {
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ]
    }
  }
}

{
  "servers": {
    "homelab-infra-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "homelab-infra-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: HOMELAB_PROXY_URL (Nginx Proxy Manager address, e.g. http://localhost:81), HOMELAB_PROXY_EMAIL (Nginx Proxy Manager admin email), HOMELAB_PROXY_PASSWORD (Nginx Proxy Manager admin password), HOMELAB_DOCKER_HOST (Docker engine address, e.g. unix:///var/run/docker.sock), HOMELAB_DOCKER_PORTAINER_URL (Portainer base URL, instead of the Docker socket), HOMELAB_DOCKER_PORTAINER_TOKEN (Portainer API key), HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID (Portainer endpoint id (default 1)), HOMELAB_DNS_API_TOKEN (Cloudflare API token with DNS edit permission), HOMELAB_DNS_ZONE_ID (Default Cloudflare zone id), HOMELAB_HOME_ASSISTANT_URL (Home Assistant address (module is off by default)), HOMELAB_HOME_ASSISTANT_TOKEN (Home Assistant long-lived access token), HOMELAB_UPTIME_ENABLED (true turns on the Uptime Kuma module (off by default)), HOMELAB_UPTIME_URL (Uptime Kuma address), HOMELAB_UPTIME_API_KEY (Uptime Kuma API key, read from /metrics), HOMELAB_TUNNEL_ENABLED (true turns on the Cloudflare Tunnel module (off by default)), HOMELAB_TUNNEL_API_TOKEN (Cloudflare API token with tunnel edit permission), HOMELAB_TUNNEL_ACCOUNT_ID (Cloudflare account id that owns the tunnel), HOMELAB_TUNNEL_TUNNEL_ID (Cloudflare Tunnel id), HOMELAB_DNS_FILTER_ENABLED (true turns on the AdGuard Home module (off by default)), HOMELAB_DNS_FILTER_URL (AdGuard Home address), HOMELAB_DNS_FILTER_USERNAME (AdGuard Home login), HOMELAB_DNS_FILTER_PASSWORD (AdGuard Home password), HOMELAB_SSO_ENABLED (true turns on the Authentik module (off by default)), HOMELAB_SSO_URL (Authentik address), HOMELAB_SSO_TOKEN (Authentik API token), HOMELAB_SSO_FLOW_SLUG (Authentik authorization flow slug used for new proxy providers), HOMELAB_READ_ONLY (true refuses every change).