Skip to main content
Glama

npm version Docker image License: MIT Node.js Version

MCP Komodo

MCP-Server für die Komodo DevOps-Plattform. Verwalten Sie Server, Stacks, Deployments, Builds und mehr über natürliche Sprache in Cursor, Claude Code und Claude Desktop.

Funktionen

  • 63 Tools in 14 Kategorien, die die vollständige Komodo-DevOps-API abdecken

  • Drei Zugriffsstufen (read-only, read-execute, full) für granulare Kontrolle

  • Kategoriefilter über KOMODO_CATEGORIES, um nur die benötigten Tools verfügbar zu machen

  • Keine HTTP-Abhängigkeiten – schlanker Native-Fetch-Client, kein SDK erforderlich

  • Docker-Images für linux/amd64 und linux/arm64 auf GHCR

  • Remote-MCP über HTTP-Transport (MCP_TRANSPORT=http) mit dem Streamable-HTTP-Protokoll

  • TypeScript/ESM mit vollständiger Typsicherheit

Related MCP server: komodo-mcp

API-Kompatibilität

Entwickelt für Komodo 1.19.5.

Schnellstart

Server direkt mit npx ausführen:

KOMODO_URL="https://komodo.example.com" \
KOMODO_API_KEY="your-api-key" \
KOMODO_API_SECRET="your-api-secret" \
npx -y @samik081/mcp-komodo

Der Server validiert Ihre Komodo-Verbindung beim Start und bricht bei fehlenden oder ungültigen Anmeldedaten sofort mit einer klaren Fehlermeldung ab.

Docker

Mit Docker ausführen (stdio-Transport, wie bei npx):

docker run --rm -i \
  -e KOMODO_URL=https://komodo.example.com \
  -e KOMODO_API_KEY=your-api-key \
  -e KOMODO_API_SECRET=your-api-secret \
  ghcr.io/samik081/mcp-komodo

So führen Sie den Server als Remote-MCP-Server mit HTTP-Transport aus:

docker run -d -p 3000:3000 \
  -e MCP_TRANSPORT=http \
  -e KOMODO_URL=https://komodo.example.com \
  -e KOMODO_API_KEY=your-api-key \
  -e KOMODO_API_SECRET=your-api-secret \
  ghcr.io/samik081/mcp-komodo

Der MCP-Endpunkt ist unter http://localhost:3000 verfügbar und ein Health-Check unter http://localhost:3000/health.

Konfiguration

Claude Code CLI (empfohlen):

# Using npx
claude mcp add --transport stdio komodo \
  --env KOMODO_URL=https://komodo.example.com \
  --env KOMODO_API_KEY=your-api-key \
  --env KOMODO_API_SECRET=your-api-secret \
  -- npx -y @samik081/mcp-komodo

# Using Docker
claude mcp add --transport stdio komodo \
  --env KOMODO_URL=https://komodo.example.com \
  --env KOMODO_API_KEY=your-api-key \
  --env KOMODO_API_SECRET=your-api-secret \
  -- docker run --rm -i ghcr.io/samik081/mcp-komodo

# Using remote HTTP (connect to a running Docker container or HTTP server)
claude mcp add --transport http komodo http://localhost:3000

JSON-Konfiguration (funktioniert mit Claude Code .mcp.json, Claude Desktop claude_desktop_config.json, Cursor .cursor/mcp.json):

{
  "mcpServers": {
    "komodo": {
      "command": "npx",
      "args": ["-y", "@samik081/mcp-komodo"],
      "env": {
        "KOMODO_URL": "https://komodo.example.com",
        "KOMODO_API_KEY": "your-api-key",
        "KOMODO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Docker (stdio):

{
  "mcpServers": {
    "komodo": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "KOMODO_URL=https://komodo.example.com",
        "-e", "KOMODO_API_KEY=your-api-key",
        "-e", "KOMODO_API_SECRET=your-api-secret",
        "ghcr.io/samik081/mcp-komodo"
      ]
    }
  }
}

Remote-MCP (Verbindung zu einem laufenden Docker-Container oder HTTP-Server):

{
  "mcpServers": {
    "komodo": {
      "type": "streamable-http",
      "url": "http://localhost:3000"
    }
  }
}

Zugriffsstufen

Steuern Sie mithilfe der Umgebungsvariablen KOMODO_ACCESS_TIER, welche Tools verfügbar sind:

Stufe

Tools

Beschreibung

full (Standard)

63

Lesen, Ausführen und Schreiben – volle Kontrolle

read-execute

55

Lesen und Ausführen – kein Erstellen/Löschen von Ressourcen, keine Benutzerverwaltung

read-only

39

Nur Lesen – sicher für Erkundung, keine Zustandsänderungen

Details zu den Stufen:

  • full: Alle 63 Tools. Enthält komodo_write_resource zum Erstellen, Aktualisieren und Löschen von Komodo-Ressourcen sowie die Benutzerverwaltungs-Tools (Dienstbenutzer, API-Schlüssel, Berechtigungen).

  • read-execute: 55 Tools. Alle Lese-Tools plus Ausführungs-Tools (deploy, pull, lifecycle, run usw.). Das Tool komodo_write_resource und die Schreib-Tools der Benutzerverwaltung sind ausgeblendet.

  • read-only: 39 Tools. Nur List, get, logs, inspect, stats, summaries, Operationsverlauf sowie Benutzer-/Berechtigungsabfragen. Alle Ausführungs- und Schreib-Tools sind ausgeblendet.

Tools, die in Ihrer Stufe nicht verfügbar sind, werden nicht beim MCP-Server registriert. Sie erscheinen nicht in der Tool-Liste Ihres KI-Tools, sodass der Kontext sauber bleibt.

Setzen Sie KOMODO_ACCESS_TIER auf read-only, read-execute oder full (Standard: full).

Umgebungsvariablen

Variable

Erforderlich

Standard

Beschreibung

KOMODO_URL

Ja

--

URL Ihrer Komodo-Core-Instanz

KOMODO_API_KEY

Ja

--

API-Schlüssel für die Authentifizierung

KOMODO_API_SECRET

Ja

--

API-Secret für die Authentifizierung

KOMODO_ACCESS_TIER

Nein

full

Zugriffsstufe: read-only, read-execute oder full

KOMODO_CATEGORIES

Nein

(alle)

Kommagetrennte Kategorie-Whitelist (z. B. servers,stacks,builds)

KOMODO_TOOL_BLACKLIST

Nein

(keine)

Kommagetrennte Liste auszuschließender Tool-Namen (z. B. komodo_destroy_stack)

KOMODO_TOOL_WHITELIST

Nein

(keine)

Kommagetrennte Liste von Tool-Namen, die erzwungen eingeschlossen werden und Zugriffsstufen- und Kategoriefilter umgehen

DEBUG

Nein

false

Debug-Logging auf stderr aktivieren

MCP_TRANSPORT

Nein

stdio

Transportmodus: stdio (Standard) oder http

MCP_PORT

Nein

3000

HTTP-Serverport (nur verwendet, wenn MCP_TRANSPORT=http)

MCP_HOST

Nein

0.0.0.0

HTTP-Server-Bind-Adresse (nur verwendet, wenn MCP_TRANSPORT=http)

MCP_EXCLUDE_TOOL_TITLES

Nein

false

Setzen Sie true, um Tool-Titel bei der Registrierung wegzulassen (spart Tokens)

Generieren Sie API-Schlüssel in der Komodo-Benutzeroberfläche unter Einstellungen > API-Schlüssel.

Verfügbare Kategorien

servers, stacks, deployments, containers, builds, repos, procedures, actions, builders, alerters, resource-syncs, updates, users, write

Tools

mcp-komodo bietet 63 Tools, die nach Kategorie organisiert sind. Die Spalte „Zugriff“ jedes Tools zeigt die mindestens erforderliche Stufe: read-only (in allen Stufen verfügbar), read-execute (erfordert read-execute oder full) oder full (nur mit Stufe full). Die Spalte „Hinweise“ zeigt das Tool-Verhalten: read-only (keine Zustandsänderungen), destructive (ändert vorhandenen Zustand), idempotent (gleiches Ergebnis bei doppeltem Aufruf).

Alle 16 Ausführungs-Tools warten standardmäßig auf den Abschluss des Vorgangs und melden sein tatsächliches Ergebnis; übergeben Sie wait: false für Fire-and-Forget oder wait_timeout_seconds, um die Wartezeit zu begrenzen (Standard: 45s).

Tool

Beschreibung

Zugriff

Hinweise

komodo_list_servers

Alle Server mit Status und Region auflisten

read-only

read-only, idempotent

komodo_get_server

Serverkonfiguration, Status und Aktionszustand abrufen

read-only

read-only, idempotent

komodo_get_server_stats

CPU-, Speicher- und Festplattennutzung sowie Lastdurchschnitte abrufen

read-only

read-only, idempotent

komodo_get_server_info

OS-Details, Hardwareinformationen und laufende Prozesse abrufen

read-only

read-only, idempotent

komodo_inspect_docker_container

Einen Docker-Container untersuchen (docker inspect-Payload); Env-Werte werden als sha256:<12-hex>-Digests dargestellt, außer wenn show_env_values: true gesetzt ist – die Schwärzung betrifft nur Env-Arrays, daher werden labels, cmd und mounts ungeschwärzt zurückgegeben

read-only

read-only, idempotent

komodo_inspect_docker_image

Ein Docker-Image untersuchen (docker image inspect-Payload); eingebackene Env-Werte werden als sha256:<12-hex>-Digests dargestellt, außer wenn show_env_values: true gesetzt ist – die Schwärzung betrifft nur Env-Arrays, daher werden labels, cmd und layers ungeschwärzt zurückgegeben

read-only

read-only, idempotent

komodo_inspect_docker_network

Ein Docker-Netzwerk untersuchen (entspricht docker network inspect)

read-only

read-only, idempotent

komodo_inspect_docker_volume

Ein Docker-Volume untersuchen (entspricht docker volume inspect)

read-only

read-only, idempotent

komodo_prune_docker

Ungenutzte Docker-Ressourcen auf einem Server bereinigen

read-execute

destructive, idempotent

komodo_delete_docker_resource

Ein bestimmtes Docker-Image, -Volume oder -Netzwerk löschen

read-execute

destructive

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_stacks

Alle Stacks mit Status, Server und Service-Anzahl auflisten

nur lesen

nur lesen, idempotent

komodo_get_stack

Stack-Konfiguration, Dienste und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_list_stack_services

Dienste in einem Stack mit Image, Container-Status und Update-Verfügbarkeit auflisten

nur lesen

nur lesen, idempotent

komodo_get_stacks_summary

Aggregierte Anzahl aller Stacks nach Status abrufen

nur lesen

nur lesen, idempotent

komodo_get_stack_log

Protokolle von Stack-Diensten abrufen, mit optionaler Suche

nur lesen

nur lesen, idempotent

komodo_inspect_stack_container

Einen Container für einen bestimmten Dienst in einem Stack inspizieren (docker inspect-Payload); Umgebungsvariablen werden als sha256:<12-hex>-Digests dargestellt, es sei denn, show_env_values: true -- die Schwärzung betrifft nur Env-Arrays, sodass Labels, cmd und Mounts ungeschwärzt zurückgegeben werden

nur lesen

nur lesen, idempotent

komodo_deploy_stack

Einen Stack bereitstellen oder erneut bereitstellen

lesen-ausführen

destruktiv

komodo_pull_stack

Neueste Images ohne erneutes Bereitstellen abrufen (docker compose pull)

lesen-ausführen

idempotent

komodo_stack_lifecycle

Einen Stack starten, stoppen, neu starten, pausieren oder fortsetzen; optional gezielt bestimmte Dienste

lesen-ausführen

destruktiv

komodo_destroy_stack

Einen Stack dauerhaft zerstören

lesen-ausführen

destruktiv

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_deployments

Alle Bereitstellungen mit Status, Image und Server auflisten

nur lesen

nur lesen, idempotent

komodo_get_deployment

Bereitstellungskonfiguration, Container-Status und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_get_deployments_summary

Aggregierte Anzahl aller Bereitstellungen nach Status abrufen

nur lesen

nur lesen, idempotent

komodo_get_deployment_log

Container-Protokolle abrufen, mit optionaler Suche

nur lesen

nur lesen, idempotent

komodo_inspect_deployment_container

Den Container für eine Bereitstellung inspizieren (docker inspect-Payload); Umgebungsvariablen werden als sha256:<12-hex>-Digests dargestellt, es sei denn, show_env_values: true -- die Schwärzung betrifft nur Env-Arrays, sodass Labels, cmd und Mounts ungeschwärzt zurückgegeben werden

nur lesen

nur lesen, idempotent

komodo_deploy_deployment

Mit neuestem Image und Konfiguration bereitstellen

lesen-ausführen

destruktiv

komodo_pull_deployment

Neuestes Image ohne erneutes Bereitstellen abrufen (docker pull)

lesen-ausführen

idempotent

komodo_deployment_lifecycle

Eine Bereitstellung starten, stoppen, neu starten, pausieren oder fortsetzen

lesen-ausführen

destruktiv

komodo_destroy_deployment

Eine Bereitstellung dauerhaft zerstören

lesen-ausführen

destruktiv

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_get_container_log

Protokolle von jedem Docker-Container auf einem Server abrufen

nur lesen

nur lesen, idempotent

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_builds

Alle Build-Konfigurationen mit Versionsinformationen auflisten

nur lesen

nur lesen, idempotent

komodo_get_build

Build-Konfiguration, Builder und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_run_build

Einen Build ausführen, um ein Docker-Image zu erstellen

lesen-ausführen

komodo_cancel_build

Einen laufenden Build abbrechen

lesen-ausführen

destruktiv, idempotent

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_repos

Alle Repos mit URL, Server und Status auflisten

nur lesen

nur lesen, idempotent

komodo_get_repo

Repo-Konfiguration, Branch und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_repo_clone_pull

Ein Repo auf seinem Zielserver klonen oder abrufen

lesen-ausführen

destruktiv

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_procedures

Alle Prozeduren mit Status auflisten

nur lesen

nur lesen, idempotent

komodo_get_procedure

Prozedurstufen, Operationen und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_run_procedure

Eine Prozedur ausführen (führt alle Stufen aus)

lesen-ausführen

destruktiv

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_actions

Alle Aktionen mit Status auflisten

nur lesen

nur lesen, idempotent

komodo_get_action

Aktionskonfiguration und Aktionsstatus abrufen

nur lesen

nur lesen, idempotent

komodo_run_action

Eine benutzerdefinierte TypeScript/Deno-Aktion ausführen

lesen-ausführen

destruktiv

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_builders

Alle Builder mit Typ auflisten

nur lesen

nur lesen, idempotent

komodo_get_builder

Builder-Typ, Serverkonfiguration und Status abrufen

nur lesen

nur lesen, idempotent

Werkzeug

Beschreibung

Zugriff

Hinweise

komodo_list_alerters

Alle Alerter mit Typ auflisten

nur lesen

nur lesen, idempotent

komodo_get_alerter

Alerter-Endpunkttyp, Konfiguration und Status abrufen

nur lesen

nur lesen, idempotent

Tool

Beschreibung

Zugriff

Hinweise

komodo_list_resource_syncs

Alle Resource-Syncs mit Status und Repo-Informationen auflisten

nur lesen

nur lesen, idempotent

komodo_get_resource_sync

Sync-Konfiguration, verwaltete Ressourcen und Status abrufen

nur lesen

nur lesen, idempotent

komodo_trigger_sync

Einen GitOps-Sync aus dem Git-Repo auslösen

lesen-ausführen

destruktiv

Tool

Beschreibung

Zugriff

Hinweise

komodo_list_updates

Operationsverlauf mit Filtern nach Ressourcentyp, Ziel, Operation und Erfolg auflisten

nur lesen

nur lesen, idempotent

komodo_get_update

Vollständige Operationsdetails inklusive Logs mit stdout/stderr für jede Stufe abrufen

nur lesen

nur lesen, idempotent

Alle 10 Benutzer-Tools erfordern ein Komodo-Admin-Konto – Komodo lehnt sie für Nicht-Admin-API-Schlüssel ab, unabhängig von der konfigurierten Zugriffsstufe.

Tool

Beschreibung

Zugriff

Hinweise

komodo_list_users

Komodo-Benutzer auflisten, optional nach Service-Benutzern filtern

nur lesen

nur lesen, idempotent

komodo_list_api_keys_for_service_user

API-Schlüssel eines Service-Benutzers auflisten (Geheimnisse werden nie zurückgegeben)

nur lesen

nur lesen, idempotent

komodo_list_permissions

Berechtigungen auflisten, die einem Benutzer oder einer Benutzergruppe gewährt wurden

nur lesen

nur lesen, idempotent

komodo_create_service_user

Einen Service-Benutzer für die Automatisierung erstellen

voll

komodo_delete_user

Einen Benutzer nach ID oder Benutzername löschen

voll

destruktiv

komodo_create_api_key_for_service_user

Einen API-Schlüssel für einen Service-Benutzer erstellen (das Geheimnis wird einmal zurückgegeben)

voll

komodo_delete_api_key_for_service_user

Den API-Schlüssel eines Service-Benutzers löschen

voll

destruktiv

komodo_update_user_base_permissions

Die Flags enabled / create-servers / create-builds eines Benutzers aktualisieren

voll

destruktiv, idempotent

komodo_update_permission_on_resource_type

Die Basisberechtigung eines Benutzers oder einer Gruppe für alle Ressourcen eines Typs festlegen

voll

destruktiv, idempotent

komodo_update_permission_on_target

Die Berechtigung eines Benutzers oder einer Gruppe für eine bestimmte Ressource festlegen

voll

destruktiv, idempotent

Tool

Beschreibung

Zugriff

Hinweise

komodo_write_resource

Beliebige Komodo-Ressource erstellen, aktualisieren oder löschen

voll

destruktiv

Funktionsprüfung

Nach der Konfiguration Ihres MCP-Clients fragen Sie Ihren KI-Assistenten:

„Welche Server sind mit Komodo verbunden?“

Wenn die Verbindung funktioniert, ruft der Assistent komodo_list_servers auf und gibt Ihre Server mit ihrem aktuellen Status und ihrer Region zurück.

Verwendungsbeispiele

Nach der Konfiguration können Sie Ihrem KI-Tool Fragen in natürlicher Sprache stellen:

  • „Alle meine Server und ihren Status auflisten“ – ruft komodo_list_servers auf, um jeden Server mit seinem aktuellen Status und seiner Region anzuzeigen.

  • „Wie hoch ist die CPU- und Speicherauslastung auf Server prod-01?“ – ruft komodo_get_server_stats auf, um die Ressourcennutzung in Echtzeit anzuzeigen.

  • „Zeig mir die Logs vom Produktions-Stack“ – ruft komodo_get_stack_log auf, um die letzten Log-Ausgaben aller Dienste im Stack abzurufen.

  • „Den Frontend-Stack bereitstellen“ – ruft komodo_deploy_stack auf, um den Stack mit seiner aktuellen Konfiguration erneut bereitzustellen.

  • „Warum ist die Bereitstellung des Frontend-Stacks fehlgeschlagen?“ – ruft komodo_list_updates auf, um die fehlgeschlagene Bereitstellung zu finden, und dann komodo_get_update, um die vollständigen Logs mit stdout/stderr anzuzeigen.

  • „Die neuesten Images für den Monitoring-Stack ziehen“ – ruft komodo_pull_stack auf, um aktualisierte Images herunterzuladen, ohne erneut bereitzustellen.

  • „Eine neue Deployment-Ressource namens api-staging mit Image myapp:latest erstellen“ – ruft komodo_write_resource auf, um eine neue Deployment-Ressource in Komodo zu erstellen.

Fehlerbehebung

Verbindung abgelehnt

Überprüfen Sie, ob KOMODO_URL korrekt ist und ob Komodo Core von dem Ort aus erreichbar ist, an dem der MCP-Server läuft. Der Server validiert die Verbindung beim Start. Wenn er also erfolgreich gestartet wurde, war die URL zu diesem Zeitpunkt gültig.

Ungültige Anmeldedaten / 401 Unauthorized

Überprüfen Sie, ob Ihr API-Schlüssel und Ihr Geheimnis korrekt sind. Stellen Sie sicher, dass der Schlüssel in der Komodo-Oberfläche unter Einstellungen > API-Schlüssel nicht widerrufen oder abgelaufen ist.

Tools werden nicht angezeigt

Überprüfen Sie Ihre Zugriffsstufen-Einstellung. Im Modus read-only sind nur 39 Tools registriert. Im Modus read-execute sind 55 Tools registriert. Verwenden Sie full (oder lassen Sie KOMODO_ACCESS_TIER weg) für alle 63 Tools. Überprüfen Sie KOMODO_CATEGORIES – nur Tools in den aufgeführten Kategorien werden registriert. Stellen Sie außerdem sicher, dass der Server ohne Fehler gestartet wurde, indem Sie die stderr-Ausgabe prüfen.

Entwicklung

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode (auto-reload)
npm run dev

# Open the MCP Inspector for interactive testing
npm run inspect

Lizenz

MIT

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
1wRelease cycle
25Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables natural language management of servers, deployments, and build pipelines through the Komodo infrastructure platform. It provides over 60 tools for automated workflows, real-time monitoring, and secure HMAC-authenticated infrastructure control.
  • A
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that exposes the full API of the Komodo infrastructure management platform. It enables users to manage deployments, stacks, servers, and containers through tools for inspection, configuration, and operational control.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Manage Komodo DevOps platform resources (servers, containers, stacks, builds) directly from AI assistants via MCP protocol. Supports OAuth 2.1 and easy Docker Compose deployment.
    13

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Samik081/mcp-komodo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server