Homelab: Nginx Proxy Manager, Docker and Cloudflare DNS, with approval for every change.
MCPpedia last refreshed this data
io.github.seayniclabs/homelab-infra-mcp is an MCP server that homelab: Nginx Proxy Manager, Docker and Cloudflare DNS, with approval for every change. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 59/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"homelab": {
"env": {
"HOMELAB_DNS_ZONE_ID": "your-zone-id",
"HOMELAB_PROXY_EMAIL": "admin@example.com",
"HOMELAB_DNS_API_TOKEN": "your-cloudflare-token",
"HOMELAB_PROXY_PASSWORD": "change-me"
},
"args": [
"homelab-infra-mcp==2.1.1"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Homelab: Nginx Proxy Manager, Docker and Cloudflare DNS, with approval for every change.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
uvx 'homelab-infra-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked homelab-infra-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in developer-tools / cloud
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Manage Supabase projects — databases, auth, storage, and edge functions
MCP server for using the GitLab API
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
MCP Security Weekly
Get CVE alerts and security updates for io.github.seayniclabs/homelab-infra-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Made by Seaynic Labs. 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.
| Module | What it does | Status |
|---|---|---|
proxy | Nginx Proxy Manager: proxy hosts, redirections, SSL certificates, access lists | On by default |
docker | Containers, images and volumes through the local Docker socket or Portainer | On by default |
dns | Cloudflare DNS zones and records, and BIND export | On by default |
home_assistant | Entities, automations, scripts and system info in Home Assistant | Off by default, turn on with HOMELAB_HOME_ASSISTANT_ENABLED=true |
uptime | Uptime Kuma monitors: list and read status (read only) | Off by default, turn on with HOMELAB_UPTIME_ENABLED=true |
tunnel | Cloudflare Tunnel routes: list, add and remove | Off by default, turn on with HOMELAB_TUNNEL_ENABLED=true |
dns_filter | AdGuard Home: filter status, query log and filter rules | Off by default, turn on with HOMELAB_DNS_FILTER_ENABLED=true |
sso | Authentik: list applications, create a proxy provider and application for one host | Off 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.
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.
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.
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.
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.
| Variable | Module | What it is |
|---|---|---|
| `HOMEL |