Dokploy MCP-Server

MCP-Server, der eine 100%ige Abdeckung der Dokploy-API bietet – 463 Tools, die automatisch aus der Dokploy-OpenAPI-Spezifikation generiert wurden. Verwalten Sie Projekte, Anwendungen, Datenbanken, Docker-Compose-Stacks und mehr direkt aus Claude.

Anforderungen

• Node.js 18+ (überprüfen mit node -v)

• Ein Dokploy-Konto mit API-Zugriff

• API-Schlüssel unter Settings → API Keys in Ihrem Dokploy-Dashboard

Schnellstart

1. Installation

npm install -g @jarciahdz111/dokploy-mcp

Oder ohne Installation ausführen:

npx @jarciahdz111/dokploy-mcp

2. Claude Desktop konfigurieren

Erstellen oder bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Fügen Sie diese Konfiguration hinzu:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

3. Claude Code CLI konfigurieren (optional)

Wenn Sie die Claude Code CLI verwenden, fügen Sie dies zu ~/.claude.json hinzu:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

4. Claude neu starten

Starten Sie Claude Desktop oder Ihr Terminal neu. Die 463 Dokploy-Tools stehen dann zur Verfügung.

Umgebungsvariablen

Verfügbare Tools

463 Tools in 42 Kategorien. Tool-Namen folgen dem Muster dokploy_{kategorie}_{aktion}.

Anwendungsbeispiele

Alle Projekte auflisten

dokploy_project_all

Docker-Container abrufen

dokploy_docker_getContainers

Anwendungsdetails abrufen

dokploy_application_one
// arguments: { applicationId: "your-application-id" }

Eine Anwendung bereitstellen

dokploy_application_deploy
// arguments: { applicationId: "your-application-id", to: "production" }

PostgreSQL-Datenbanken auflisten

dokploy_postgres_all

Serverstatus abrufen

dokploy_settings_getDokployVersion

Einen Docker-Container neu starten

dokploy_docker_restartContainer
// arguments: { containerId: "your-container-id" }

Lokale Entwicklung

# Clone the repository
git clone https://github.com/jarciahdz111/dokploy-mcp.git
cd dokploy-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test
node test-mcp.js

Fehlerbehebung

"Unauthorized"-Fehler

Ihr DOKPLOY_API_KEY ist ungültig oder abgelaufen.

1. Gehen Sie zu Settings → API Keys in Ihrem Dokploy-Dashboard

2. Generieren Sie einen neuen API-Schlüssel

3. Aktualisieren Sie den DOKPLOY_API_KEY in Ihrer Claude Desktop-Konfiguration

4. Starten Sie Claude neu

"Connection Refused"-Fehler

Der Server kann Ihre Dokploy-Instanz nicht erreichen.

1. Überprüfen Sie, ob DOKPLOY_URL korrekt ist (muss am Ende /api enthalten)

2. Überprüfen Sie, ob Ihr Dokploy-Server läuft und erreichbar ist

3. Wenn Sie sich hinter einer Unternehmens-Firewall befinden, setzen Sie Proxy-Umgebungsvariablen:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

Request Timeout-Fehler

Die Anfrage hat zu lange gedauert und wurde abgebrochen.

Erhöhen Sie das Timeout durch Setzen von REQUEST_TIMEOUT_MS:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

Debug-Logging aktivieren

Um detaillierte Anfrage-/Antwort-Logs zu sehen:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "DEBUG": "1"
      }
    }
  }
}

Die Debug-Ausgabe wird als JSON an stderr geschrieben.

Funktionsweise

Dieser MCP-Server wird automatisch aus der Dokploy-OpenAPI-Spezifikation generiert. Wenn Dokploy ein API-Update veröffentlicht, kann eine neue Version dieses Pakets mit aktualisierter Tool-Abdeckung veröffentlicht werden – kein manuelles Schreiben von Tools erforderlich.

Der Server:

1. Lädt die eingebettete OpenAPI-Spezifikation (1,4 MB, 463 Endpunkte)

2. Konvertiert jeden Endpunkt in ein MCP-Tool mit Zod-validiertem Eingabeschema

3. Leitet GET-Anfragen als tRPC-Queries und POST-Anfragen als tRPC-Mutationen weiter

4. Handhabt tRPC-Antwort-Wrapping und Fehler-Parsing automatisch

API-Abdeckung

• 100% der Dokploy-API v0.28.8-Endpunkte

• 463 MCP-Tools

• 42 funktionale Kategorien

• Automatisch generiert und mit der API-Spezifikation synchronisiert

Mitwirken

Möchten Sie diesen MCP-Server ändern oder erweitern? Siehe CLAUDE.md für den Entwicklungs-Workflow, die Architekturübersicht und Richtlinien für Beiträge.

Lizenz

MIT