master-mcp
Enables Authentik administration for users, groups, applications, providers, outposts, flows, events, and invitations.
Allows admin management of Cloudflare zones, DNS records, cache purging, firewall/WAF rules, IP access rules, page rules, custom hostnames, SSL/TLS certificate packs, zone settings, and analytics.
Enables Docker host administration, including containers, images, volumes, networks, stats, logs, container lifecycle operations, and pruning.
Allows management of Nginx Proxy Manager / NPMPlus proxy hosts, redirection hosts, streams, access lists, certificates, users, settings, and Let's Encrypt certificate requests.
Provides tools for managing Porkbun domains, DNS records, URL forwarding, nameservers, SSL bundles, and TLD pricing.
Provides Proxmox VE administration capabilities for nodes, VMs/LXCs, snapshots, backups, storage, cluster status, users, and background tasks.
Provides tools for managing Uptime Kuma monitors, heartbeats, maintenance windows, status pages, and notifications.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@master-mcp restart the nginx container and show me its last 50 log lines"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
master-mcp
Ein einziger MCP-Server (stdio, TypeScript) für die Admin-Verwaltung von:
Cloudflare (Zonen, DNS, Cache, Firewall/WAF, Custom Hostnames, Zone-Settings, Analytics)
Porkbun (Domains, DNS, URL-Forwarding, Nameserver, SSL-Bundle, Pricing)
Docker (Container, Images, Volumes, Netzwerke, Stats, Logs - lokaler Socket oder Remote-TCP)
Proxmox VE (Nodes, VMs/LXCs, Snapshots, Backups, Storage, Cluster, Tasks)
Nginx Proxy Manager / NPMPlus (Proxy-Hosts, Redirects, Streams, Access-Lists, Zertifikate, Users)
Uptime Kuma (Monitore, Heartbeats, Wartungsfenster, Status-Pages, Notifications)
Authentik (Users, Gruppen, Applications, Providers, Outposts, Flows, Events, Invitations)
Coolify (Applications, Deployments, Datenbanken, Services, Server, Projekte, Teams)
Alle Aktionen im Detail
Der Server exponiert selbst nur drei MCP-Tools (list_services, list_actions,
execute_action - siehe Architektur). Die eigentlichen ~150 Aktionen
sind serverseitig in einem Katalog organisiert; hier die vollständige Liste je Dienst.
Jede Aktion wird über execute_action mit service, action, optional instance und
den unten genannten Parametern aufgerufen. ⚠️ markiert destruktive Aktionen
(Löschen/Stop/Prune/... - irreversibel oder zustandsändernd mit Risiko).
Cloudflare (21 Aktionen)
Aktion | Beschreibung |
| Zonen (Domains) im Account auflisten, optional nach Name gefiltert |
| Details einer einzelnen Zone per ID |
| DNS-Records einer Zone auflisten, optional nach Typ/Name gefiltert |
| Neuen DNS-Record (A, AAAA, CNAME, TXT, MX, ...) anlegen |
| Felder eines bestehenden DNS-Records ändern |
| DNS-Record löschen |
| Edge-Cache einer Zone leeren (bestimmte Dateien oder alles) |
| (Legacy) Firewall-Regeln einer Zone auflisten |
| Alle Zone-Settings lesen (SSL-Modus, Always-Online, Minify, ...) |
| Ein Zone-Setting ändern (z.B. |
| Page Rules einer Zone auflisten |
| Page Rule mit Ziel-URL-Muster und Aktionen anlegen |
| Page Rule löschen |
| IP/Land/ASN-Zugriffsregeln (Block/Challenge/Whitelist) auflisten |
| IP/IP-Range/Land/ASN-Zugriffsregel anlegen |
| IP-Zugriffsregel löschen |
| SSL/TLS-Zertifikatspakete einer Zone auflisten |
| Custom Hostnames (SSL for SaaS) auflisten |
| Custom Hostname anlegen |
| Custom Hostname löschen |
| Analytics-Dashboard-Summen (Requests, Bandbreite, Threats) für einen Zeitraum |
Porkbun (13 Aktionen)
Aktion | Beschreibung |
| API-Erreichbarkeit prüfen, liefert die öffentliche IP zurück - guter Smoke-Test |
| Alle Domains im Account auflisten (paginiert, optional mit Labels) |
| DNS-Records einer Domain abrufen (per ID, per Typ+Subdomain, oder alle) |
| Neuen DNS-Record anlegen |
| Bestehenden DNS-Record ändern |
| DNS-Record löschen |
| Autoritative Nameserver einer Domain ändern (wirkt global auf die Auflösung) |
| Kostenloses SSL-Zertifikatsbündel (Chain, Private Key, Public Key) abrufen |
| Bestehende URL-Weiterleitungen einer Domain auflisten |
| URL-Weiterleitung für Domain/Subdomain anlegen |
| URL-Weiterleitung löschen |
| Aktuelle Nameserver einer Domain abrufen |
| Porkbuns TLD-Preisliste abrufen (Registrierung, Verlängerung, Transfer) |
Docker (25 Aktionen)
Aktion | Beschreibung |
| Container auflisten (per Default nur laufende, |
| Vollständige Inspect-Details (Config, State, Mounts, Netzwerk) eines Containers |
| Gestoppten Container starten |
| Laufenden Container stoppen, optional mit Grace-Timeout |
| Container neu starten, optional mit Grace-Timeout |
| Container entfernen, optional forciert + inkl. Volumes |
| Aktuelle stdout/stderr-Logs (mit Zeitstempeln) abrufen |
| Vorhandene Images auf dem Host auflisten |
| Image (optional bestimmter Tag) aus der Registry ziehen |
| Volumes auf dem Host auflisten |
| Netzwerke auf dem Host auflisten |
| Kompakte Host-Zusammenfassung (Container-/Image-Zahlen, Version, OS, CPU, RAM) |
| Container umbenennen |
| Momentaufnahme der Ressourcennutzung (CPU %, Speicher, Netzwerk-I/O) |
| Laufende Prozesse in einem Container auflisten (wie |
| Neuen Container aus einem Image anlegen, optional sofort starten |
| Alle gestoppten Container entfernen |
| Image entfernen, optional forciert |
| Neues repo:tag auf ein bestehendes Image anwenden |
| Ungenutzte Images entfernen (per Default nur dangling) |
| Netzwerk anlegen (Default-Driver: bridge) |
| Netzwerk entfernen |
| Volume anlegen (Default-Driver: local) |
| Volume entfernen, optional forciert |
| Alle ungenutzten Volumes entfernen |
Proxmox VE (19 Aktionen)
Aktion | Beschreibung |
| Cluster-Nodes mit Status, CPU, Memory, Uptime auflisten |
| VMs (qemu) und/oder LXC-Container auflisten, pro Node oder Cluster-weit |
| Aktuellen Status (running/stopped, CPU, Mem, Uptime) einer VM/eines LXC abrufen |
| Gestoppte VM/LXC starten |
| VM/LXC hart stoppen (wie Stromstecker ziehen) - Datenverlust bei ungesichertem Zustand möglich |
| VM/LXC per ACPI/Agent-Signal sauber herunterfahren |
| VM/LXC sauber neu starten |
| Storage-Pools auflisten (pro Node oder Cluster-Konfiguration) |
| Cluster-Status: Member-Nodes, Quorum, Cluster-Info |
| Konfiguration (Cores, Memory, Disks, Netzwerk, ...) einer VM/eines LXC abrufen |
| Konfiguration (Cores, Memory, Beschreibung) einer VM/eines LXC ändern |
| Snapshots einer VM/eines LXC auflisten |
| Neuen Snapshot anlegen |
| Snapshot löschen |
| VM/LXC auf einen Snapshot zurücksetzen, verwirft den aktuellen Zustand |
| Backup-Archive auf einem Node auflisten (bestimmter Storage oder alle) |
| Detaillierten Node-Status abrufen (Uptime, Load, Memory, CPU) |
| Proxmox-Zugriffskontroll-Benutzer auflisten |
| Status eines Background-Tasks per UPID abfragen (z.B. laufenden Start/Stop/Snapshot-Task pollen) |
Nginx Proxy Manager / NPMPlus (19 Aktionen)
Aktion | Beschreibung |
| Alle Proxy-Hosts auflisten, inkl. Owner/Access-List/Zertifikat-Details wenn unterstützt |
| Neuen Reverse-Proxy-Host anlegen (Domain(s) → Forward-Ziel, SSL/Caching/Security-Optionen) |
| Forward-Ziel, Domains, SSL oder Security-Einstellungen eines Hosts ändern |
| Proxy-Host löschen |
| Deaktivierten Proxy-Host aktivieren |
| Proxy-Host deaktivieren - nimmt die dahinterliegende Seite offline |
| Konfigurierte Redirection-Hosts (Domain-Weiterleitungen) auflisten |
| Konfigurierte TCP/UDP-Streams auflisten |
| Konfigurierte Access-Lists (Basic-Auth/Allow-Deny-Regeln) auflisten |
| Bekannte SSL-Zertifikate auflisten |
| NPM/NPMPlus-Benutzer auflisten |
| Neuen NPM-Benutzer anlegen und Passwort setzen (zweistufig: User anlegen, dann Auth setzen) |
| Name/Nickname/E-Mail/Admin-Rolle/Disabled-Status eines Benutzers ändern |
| NPM-Benutzer löschen |
| Konfigurierte 404/Catch-all-("Dead")-Hosts auflisten |
| Alle NPM/NPMPlus-Anwendungseinstellungen auflisten |
| Eine Anwendungseinstellung per ID ändern (z.B. |
| Neues Let's-Encrypt-Zertifikat für eine oder mehrere Domains anfordern |
| SSL-Zertifikat löschen |
Uptime Kuma (11 Aktionen)
Aktion | Beschreibung |
| Alle Monitore (ID, Name, Typ, URL/Hostname, Aktiv-Status, Check-Intervall) auflisten |
| Historische Heartbeats (Up/Down über die Zeit) für einen Monitor, über einen Zeitraum in Stunden |
| Monitor pausieren - stoppt Checks und Alerting bis zur Wiederaufnahme |
| Pausierten Monitor wieder aktivieren |
| Monitor und dessen Historie dauerhaft löschen |
| Neuen HTTP(s)-Monitor anlegen, der eine URL periodisch auf Erreichbarkeit prüft |
| Name/URL/Check-Intervall/Retry-Intervall/Resend-Intervall/Aktiv-Status eines Monitors ändern |
| Konfigurierte Notification-Provider (E-Mail, Discord, Telegram, ...) auflisten |
| Konfigurierte Wartungsfenster auflisten |
| Wartungsfenster anlegen, optional auf bestimmte Monitore beschränkt, unterdrückt Alerts währenddessen |
| Öffentliche Status-Pages auflisten, keyed nach Slug |
Hinweis: Accounts mit 2FA werden nicht unterstützt (Login schlägt mit klarer Fehlermeldung fehl, statt hängenzubleiben).
Authentik (16 Aktionen)
Aktion | Beschreibung |
| Authentik-Benutzer auflisten, optional nach Suchtext/Aktiv-Status gefiltert |
| Details eines einzelnen Benutzers per ID |
| Neuen Benutzer anlegen (Username, Name, E-Mail, optionale Gruppenmitgliedschaften) |
| Name/E-Mail/Aktiv-Status eines bestehenden Benutzers ändern |
| Benutzer löschen |
| Passwort eines Benutzers setzen/zurücksetzen |
| Gruppen auflisten, optional nach Suchtext gefiltert |
| Neue Gruppe anlegen, optional mit Superuser-Rechten |
| Benutzer einer Gruppe hinzufügen |
| Benutzer aus einer Gruppe entfernen |
| Applications auflisten, optional nach Suchtext gefiltert |
| Alle Provider auflisten (OAuth2, SAML, Proxy, LDAP, ... - alle Typen kombiniert) |
| Outpost-Instanzen (Proxy/LDAP/RADIUS-Deployments) und deren Health auflisten |
| Flows (Login, Enrollment, Recovery, ...) auflisten, optional nach Suchtext gefiltert |
| Audit-Log-Events auflisten, standardmäßig neueste zuerst |
| Enrollment-Einladung anlegen, optional mit vorausgefüllten Daten und Ablaufdatum |
Coolify (27 Aktionen)
Aktion | Beschreibung |
| Alle Applications über alle Projekte/Server auflisten |
| Vollständige Details einer Application per UUID |
| Gestoppte Application starten |
| Laufende Application stoppen |
| Application neu starten |
| Deployment anstoßen (per Application/Resource-UUID oder Tag), optional erzwungener No-Cache-Rebuild |
| Aktuelle Logs einer Application abrufen |
| Umgebungsvariablen einer Application auflisten |
| Umgebungsvariable einer Application anlegen/überschreiben |
| Umgebungsvariable einer Application per Key löschen |
| Aktuell laufende/wartende Deployments auflisten |
| Details/Status eines Deployments per UUID |
| Alle Coolify-verwalteten Datenbanken auflisten |
| Vollständige Details einer Datenbank per UUID |
| Gestoppte Datenbank starten |
| Laufende Datenbank stoppen |
| Datenbank neu starten |
| Alle Services auflisten (One-Click-App-Stacks wie Plausible, Ghost, ...) |
| Vollständige Details eines Service per UUID |
| Gestoppten Service starten |
| Laufenden Service stoppen |
| Service neu starten |
| Alle mit dieser Coolify-Instanz verbundenen Server auflisten |
| Vollständige Details eines Servers per UUID, inkl. Erreichbarkeits-/Nutzbarkeits-Status |
| Alle Projekte auflisten |
| Vollständige Details eines Projekts per UUID, inkl. Environments/Ressourcen |
| Alle Teams auflisten, auf die dieser API-Token Zugriff hat |
Related MCP server: MCP Hub
Architektur
Token-effizientes Search+Execute-Pattern statt eines Tools pro Aktion: der Server
exponiert nur drei MCP-Tools (list_services, list_actions, execute_action); die
eigentlichen 151 Aktionen (siehe Alle Aktionen im Detail)
liegen serverseitig in einem Katalog und werden erst bei Bedarf per Freitextsuche
gefunden.
Jeder Dienst kann mehrere benannte Instanzen mit eigenen Zugangsdaten/Zielen haben
(z.B. zwei Docker-Hosts oder zwei Proxmox-Nodes) - siehe .env.example.
src/
core/
types.ts - ActionDef/ServiceModule/InstanceConfig Interfaces
instances.ts - Multi-Instanz-Discovery aus ENV-Variablen
registry.ts - Katalog, Suche, Instanz-Auflösung
http.ts - axios-Client-Helper
services/
cloudflare.ts, porkbun.ts, docker.ts, proxmox.ts, npm.ts, uptimeKuma.ts, authentik.ts, coolify.ts
index.ts - Aggregiert alle ServiceModules
index.ts - MCP-Server-Wiring (stdio)Setup
npm install
cp .env.example .env # eintragen, welche Dienste genutzt werden
npm run buildIn Claude Code registrieren
claude mcp add master-mcp -- node /pfad/zu/masterMCP/dist/index.js(oder die passende Konfiguration in claude_desktop_config.json / MCP-Client
deiner Wahl - stdio-Transport, Env-Variablen aus .env werden beim Start via
dotenv geladen.)
Entwicklung
npm run dev # tsx, ohne Build
npm run typecheck
npm test # vitest, 146 Tests über alle 8 Module
npm run buildSicherheit
Alle Credentials kommen ausschließlich aus Umgebungsvariablen (
.env, nie committen).execute_actionmarkiert jede Aktion alsreadOnly/destructive- destruktive Aktionen (Löschen, Stop/Reboot, Prune, ...) sind klar gekennzeichnet.insecureTls-Felder (Proxmox, NPM, Authentik, Docker-TLS) sind Opt-in und standardmäßigfalse- nur für selbstsignierte LAN-Zertifikate gedacht.
Available Tools
3 toolsexecute_actionA
Execute one action against one instance of a service. Look up the action id and its params schema via list_actions first. instance selects which configured target to use (e.g. which Proxmox node or Docker host) - omit it only if the service has exactly one instance configured. Destructive actions (as flagged by list_actions) change or delete remote state - double check params before calling.
Inputs: action (required), service (required), params, instance.
list_actionsA
Search/list available actions across configured services. Returns each action's id, owning service, a one-line summary, whether it's read-only or destructive, and its JSON input schema. Use query to search by keyword (e.g. 'restart container', 'dns record', 'proxy host'); omit both filters to list everything. Only configured services' actions are returned.
Inputs: query, service.
list_servicesA
List all admin services this MCP can reach (Uptime Kuma, NPMPlus/Nginx Proxy Manager, Porkbun, Cloudflare, Docker, Proxmox), which are configured, and which named instances exist for each (e.g. multiple Docker hosts or Proxmox nodes with separate credentials). Call this first if you're unsure what's available.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools target clearly distinct phases: discovering services/instances, discovering available actions, and executing a chosen action. There is no overlap in purpose, and the descriptions reinforce the correct order of use.
All tool names follow a consistent verb_noun snake_case pattern: list_services, list_actions, execute_action. The plural vs. singular noun choice is natural for listing multiple items versus executing one action.
Three tools are well-scoped for a generic admin-action gateway: one for service discovery, one for action discovery, and one for execution. The dynamic action surface avoids tool bloat while covering the server's purpose.
The tool set provides complete lifecycle support for the gateway pattern: list services/instances, list available actions with schemas and safety flags, and execute any action against a chosen instance. No obvious operational gaps exist for the stated domain.
Maintenance
Related MCP Connectors
Zero-dependency Cloudflare Worker gateway turning websites and REST APIs into MCP tools.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables conversational management of Hetzner Cloud, DNS, and Storage Box infrastructure through 137 MCP tools for CRUD operations and actions like server power control, DNS zone management, and storage box snapshots.100MIT
- AlicenseNot gradedqualityCmaintenanceA single MCP server that gives an AI assistant comprehensive access to manage a homelab, including SSH, Docker, Proxmox, Synology, Cloudflare, and more, with 85 tools and a centralized configuration.MIT
- AlicenseNot gradedqualityCmaintenanceProvider-agnostic MCP server for managing heterogeneous infrastructure (SSH, Proxmox VE, Virtualizor, Hetzner Cloud, Cloudflare) via a JSON inventory, exposing tools for VM/container management, DNS, firewalls, and SSH operations.MIT
- AlicenseNot gradedqualityCmaintenanceProvides a unified MCP interface to manage Cloudflare services including DNS, compute (Workers, KV, D1), storage (R2), AI, security, Radar, and a universal API gateway for any Cloudflare v4 endpoint.MIT