PlugLayer MCP-Server

Name: PlugLayer MCP Server
Author: pluglayer

Stellen Sie Ihre Infrastruktur bereit und verwalten Sie diese mittels natürlicher Sprache mit jedem MCP-kompatiblen KI-Assistenten.

Installation

Option 1: uvx (empfohlen — keine Installation erforderlich)

PLUGLAYER_API_KEY=your-pluglayer-api-token uvx pluglayer-mcp

Optional:

PLUGLAYER_API_BASE_URL=https://api.pluglayer.com

Option 2: pip

pip install pluglayer-mcp
PLUGLAYER_API_KEY=your-pluglayer-api-token pluglayer-mcp

Konfiguration

Claude Desktop

Hinzufügen zu ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pluglayer": {
      "command": "uvx",
      "args": ["pluglayer-mcp"],
      "env": {
        "PLUGLAYER_API_KEY": "your-pluglayer-api-token",
        "PLUGLAYER_API_BASE_URL": "https://api.pluglayer.com"
      }
    }
  }
}

Cursor

Hinzufügen zu ~/.cursor/mcp.json:

{
  "pluglayer": {
    "command": "uvx",
    "args": ["pluglayer-mcp"],
    "env": {
      "PLUGLAYER_API_KEY": "your-pluglayer-api-token",
      "PLUGLAYER_API_BASE_URL": "https://api.pluglayer.com"
    }
  }
}

Remote HTTP (gehostet)

Der Remote-MCP-Server läuft unter mcp.pluglayer.com. Übergeben Sie Ihr Token wie folgt:

Authorization: Bearer your-pluglayer-api-token

Verhalten der API-Basis-URL

PLUGLAYER_API_BASE_URL ist die bevorzugte Umgebungsvariable für den Ursprung der Backend-API.
Wenn sie nicht gesetzt oder leer ist, verwendet der MCP standardmäßig https://api.pluglayer.com.
PLUGLAYER_API_URL wird während der Migration weiterhin als Legacy-Fallback akzeptiert.

Verfügbare Tools

Der MCP ruft das PlugLayer FastAPI-Backend auf, anstatt die Backend-Geschäftslogik neu zu implementieren. Authentifizierung, Rollen, Eigentümerschaft, Compute-Guards, k3s-Orchestrierung und Admin-Prüfungen verbleiben im Backend. MCP- und Editor-Plugins sollten sich mit einem PlugLayer API-Token authentifizieren, das auf der PlugLayer-Einstellungsseite erstellt wurde, nicht mit dem Browser-/Sitzungs-Authentifizierungstoken.

Verwaltete Registries werden von PlugLayer-Administratoren in der Plattform-UI/API konfiguriert. Wenn deploy_image Mirroring verwendet, wählt das Backend eine Registry aus, die der aktuelle Benutzer verwenden darf, und hält Kubernetes-Pull-Secrets automatisch synchron.

Tool	Beschreibung
`get_current_user`	Zeigt den Authentik-basierten Benutzer und die `roles` an
`list_projects`	Listet die Projekte des authentifizierten Benutzers auf
`create_project`	Erstellt einen neuen Projekt-Namespace
`get_project`	Ruft Projektdetails ab
`get_compute_summary`	Zeigt die persönliche + geteilte Rechenkapazität auf Kontoebene an
`list_nodes`	Listet zugängliche Rechenknoten auf
`add_node_ssh`	Fügt einen persönlichen SSH-Knoten hinzu, der von allen Projekten des Benutzers genutzt werden kann
`list_registries`	Listet die aktuell für den Benutzer verfügbaren Registries auf
`deploy_image`	Spiegelt ein Docker-Image in den verwalteten Docker Hub-Namespace von PlugLayer und stellt es nach Backend-Compute-Prüfungen bereit
`deploy_compose`	Stellt nach Backend-Compute-Prüfungen aus einer docker-compose.yml bereit
`list_deployments`	Listet laufende Apps/Deployments auf
`get_deployment_status`	Überprüft App-Status und URL
`get_logs`	Ruft App-Logs ab
`redeploy`	Stellt eine App erneut bereit
`rollback`	Führt ein Rollback auf die vorherige Version durch
`delete_deployment`	Löscht eine App
`list_project_domains`	Listet benutzerdefinierte Domains für ein Projekt auf
`add_custom_domain`	Fügt eine einzelne oder Wildcard-benutzerdefinierte Domain hinzu und gibt DNS-Einträge zurück
`verify_custom_domain`	Überprüft TXT/CNAME DNS und aktiviert die Domain, falls angehängt
`attach_custom_domain`	Hängt eine verifizierte benutzerdefinierte Domain an eine App an
`detach_custom_domain`	Trennt eine Domain, behält aber die Verifizierung bei
`remove_custom_domain`	Entfernt eine Domain und deren Route
`get_task_status`	Fragt den Fortschritt asynchroner Vorgänge ab
`admin_get_overview`	Plattform-Übersicht nur für Administratoren
`admin_set_compute_defaults`	Standard-Compute-Kontingent-Metadaten nur für Administratoren
`admin_set_node_shared`	Markiert einen Knoten als geteilt/privat (nur für Administratoren)
`admin_add_shared_ssh_node`	Fügt geteilte PlugLayer SSH-Compute hinzu (nur für Administratoren)
`generate_github_actions`	Ruft CI/CD-Pipeline YAML ab
`get_cluster_health`	Überprüft den Cluster-Status

Beispielkonversationen

Stellen Sie Ihre erste App bereit:

"Ich habe eine FastAPI-App unter ghcr.io/myorg/api:latest, die auf Port 8000 läuft. Stelle sie in meinem production-Projekt bereit."

Konvertieren Sie docker-compose:

"Hier ist meine docker-compose.yml: [einfügen]. Stelle dies auf PlugLayer bereit."

Fügen Sie einen Knoten hinzu:

"Füge meinen Server unter 192.168.1.100 als persönlichen Compute hinzu. Hier ist mein SSH-Schlüssel: [einfügen]"

CI/CD-Einrichtung:

"Generiere einen GitHub Actions-Workflow für mein api-Deployment, damit es bei einem Push auf main automatisch bereitgestellt wird."

Fügen Sie eine benutzerdefinierte Domain hinzu:

"Füge api.example.com zu meinem Produktionsprojekt hinzu, zeige mir die DNS-Einträge, verifiziere sie dann und hänge sie an meine API-App an."

Erhalt Ihres API-Schlüssels

Gehen Sie zu den PlugLayer-Einstellungen
Erstellen Sie ein PlugLayer API-Token
Kopieren Sie es einmal und speichern Sie es sicher
Verwenden Sie es als PLUGLAYER_API_KEY für MCP, Editor-Plugins und CI/CD-Webhook-Deployments

PlugLayer MCP Server