mcp-komodo
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 KontrolleKategoriefilter über
KOMODO_CATEGORIES, um nur die benötigten Tools verfügbar zu machenKeine HTTP-Abhängigkeiten – schlanker Native-Fetch-Client, kein SDK erforderlich
Docker-Images für
linux/amd64undlinux/arm64auf GHCRRemote-MCP über HTTP-Transport (
MCP_TRANSPORT=http) mit dem Streamable-HTTP-ProtokollTypeScript/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-komodoDer 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-komodoSo 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-komodoDer 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:3000JSON-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 |
| 63 | Lesen, Ausführen und Schreiben – volle Kontrolle |
| 55 | Lesen und Ausführen – kein Erstellen/Löschen von Ressourcen, keine Benutzerverwaltung |
| 39 | Nur Lesen – sicher für Erkundung, keine Zustandsänderungen |
Details zu den Stufen:
full: Alle 63 Tools. Enthält
komodo_write_resourcezum 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_resourceund 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 |
| Ja | -- | URL Ihrer Komodo-Core-Instanz |
| Ja | -- | API-Schlüssel für die Authentifizierung |
| Ja | -- | API-Secret für die Authentifizierung |
| Nein |
| Zugriffsstufe: |
| Nein | (alle) | Kommagetrennte Kategorie-Whitelist (z. B. |
| Nein | (keine) | Kommagetrennte Liste auszuschließender Tool-Namen (z. B. |
| Nein | (keine) | Kommagetrennte Liste von Tool-Namen, die erzwungen eingeschlossen werden und Zugriffsstufen- und Kategoriefilter umgehen |
| Nein |
| Debug-Logging auf stderr aktivieren |
| Nein |
| Transportmodus: |
| Nein |
| HTTP-Serverport (nur verwendet, wenn |
| Nein |
| HTTP-Server-Bind-Adresse (nur verwendet, wenn |
| Nein |
| Setzen Sie |
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 |
| Alle Server mit Status und Region auflisten | read-only | read-only, idempotent |
| Serverkonfiguration, Status und Aktionszustand abrufen | read-only | read-only, idempotent |
| CPU-, Speicher- und Festplattennutzung sowie Lastdurchschnitte abrufen | read-only | read-only, idempotent |
| OS-Details, Hardwareinformationen und laufende Prozesse abrufen | read-only | read-only, idempotent |
| Einen Docker-Container untersuchen ( | read-only | read-only, idempotent |
| Ein Docker-Image untersuchen ( | read-only | read-only, idempotent |
| Ein Docker-Netzwerk untersuchen (entspricht docker network inspect) | read-only | read-only, idempotent |
| Ein Docker-Volume untersuchen (entspricht docker volume inspect) | read-only | read-only, idempotent |
| Ungenutzte Docker-Ressourcen auf einem Server bereinigen | read-execute | destructive, idempotent |
| Ein bestimmtes Docker-Image, -Volume oder -Netzwerk löschen | read-execute | destructive |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Stacks mit Status, Server und Service-Anzahl auflisten | nur lesen | nur lesen, idempotent |
| Stack-Konfiguration, Dienste und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Dienste in einem Stack mit Image, Container-Status und Update-Verfügbarkeit auflisten | nur lesen | nur lesen, idempotent |
| Aggregierte Anzahl aller Stacks nach Status abrufen | nur lesen | nur lesen, idempotent |
| Protokolle von Stack-Diensten abrufen, mit optionaler Suche | nur lesen | nur lesen, idempotent |
| Einen Container für einen bestimmten Dienst in einem Stack inspizieren ( | nur lesen | nur lesen, idempotent |
| Einen Stack bereitstellen oder erneut bereitstellen | lesen-ausführen | destruktiv |
| Neueste Images ohne erneutes Bereitstellen abrufen (docker compose pull) | lesen-ausführen | idempotent |
| Einen Stack starten, stoppen, neu starten, pausieren oder fortsetzen; optional gezielt bestimmte Dienste | lesen-ausführen | destruktiv |
| Einen Stack dauerhaft zerstören | lesen-ausführen | destruktiv |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Bereitstellungen mit Status, Image und Server auflisten | nur lesen | nur lesen, idempotent |
| Bereitstellungskonfiguration, Container-Status und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Aggregierte Anzahl aller Bereitstellungen nach Status abrufen | nur lesen | nur lesen, idempotent |
| Container-Protokolle abrufen, mit optionaler Suche | nur lesen | nur lesen, idempotent |
| Den Container für eine Bereitstellung inspizieren ( | nur lesen | nur lesen, idempotent |
| Mit neuestem Image und Konfiguration bereitstellen | lesen-ausführen | destruktiv |
| Neuestes Image ohne erneutes Bereitstellen abrufen (docker pull) | lesen-ausführen | idempotent |
| Eine Bereitstellung starten, stoppen, neu starten, pausieren oder fortsetzen | lesen-ausführen | destruktiv |
| Eine Bereitstellung dauerhaft zerstören | lesen-ausführen | destruktiv |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Protokolle von jedem Docker-Container auf einem Server abrufen | nur lesen | nur lesen, idempotent |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Build-Konfigurationen mit Versionsinformationen auflisten | nur lesen | nur lesen, idempotent |
| Build-Konfiguration, Builder und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Einen Build ausführen, um ein Docker-Image zu erstellen | lesen-ausführen | — |
| Einen laufenden Build abbrechen | lesen-ausführen | destruktiv, idempotent |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Repos mit URL, Server und Status auflisten | nur lesen | nur lesen, idempotent |
| Repo-Konfiguration, Branch und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Ein Repo auf seinem Zielserver klonen oder abrufen | lesen-ausführen | destruktiv |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Prozeduren mit Status auflisten | nur lesen | nur lesen, idempotent |
| Prozedurstufen, Operationen und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Eine Prozedur ausführen (führt alle Stufen aus) | lesen-ausführen | destruktiv |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Aktionen mit Status auflisten | nur lesen | nur lesen, idempotent |
| Aktionskonfiguration und Aktionsstatus abrufen | nur lesen | nur lesen, idempotent |
| Eine benutzerdefinierte TypeScript/Deno-Aktion ausführen | lesen-ausführen | destruktiv |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Builder mit Typ auflisten | nur lesen | nur lesen, idempotent |
| Builder-Typ, Serverkonfiguration und Status abrufen | nur lesen | nur lesen, idempotent |
Werkzeug | Beschreibung | Zugriff | Hinweise |
| Alle Alerter mit Typ auflisten | nur lesen | nur lesen, idempotent |
| Alerter-Endpunkttyp, Konfiguration und Status abrufen | nur lesen | nur lesen, idempotent |
Tool | Beschreibung | Zugriff | Hinweise |
| Alle Resource-Syncs mit Status und Repo-Informationen auflisten | nur lesen | nur lesen, idempotent |
| Sync-Konfiguration, verwaltete Ressourcen und Status abrufen | nur lesen | nur lesen, idempotent |
| Einen GitOps-Sync aus dem Git-Repo auslösen | lesen-ausführen | destruktiv |
Tool | Beschreibung | Zugriff | Hinweise |
| Operationsverlauf mit Filtern nach Ressourcentyp, Ziel, Operation und Erfolg auflisten | nur lesen | nur lesen, idempotent |
| 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-Benutzer auflisten, optional nach Service-Benutzern filtern | nur lesen | nur lesen, idempotent |
| API-Schlüssel eines Service-Benutzers auflisten (Geheimnisse werden nie zurückgegeben) | nur lesen | nur lesen, idempotent |
| Berechtigungen auflisten, die einem Benutzer oder einer Benutzergruppe gewährt wurden | nur lesen | nur lesen, idempotent |
| Einen Service-Benutzer für die Automatisierung erstellen | voll | – |
| Einen Benutzer nach ID oder Benutzername löschen | voll | destruktiv |
| Einen API-Schlüssel für einen Service-Benutzer erstellen (das Geheimnis wird einmal zurückgegeben) | voll | – |
| Den API-Schlüssel eines Service-Benutzers löschen | voll | destruktiv |
| Die Flags enabled / create-servers / create-builds eines Benutzers aktualisieren | voll | destruktiv, idempotent |
| Die Basisberechtigung eines Benutzers oder einer Gruppe für alle Ressourcen eines Typs festlegen | voll | destruktiv, idempotent |
| Die Berechtigung eines Benutzers oder einer Gruppe für eine bestimmte Ressource festlegen | voll | destruktiv, idempotent |
Tool | Beschreibung | Zugriff | Hinweise |
| 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_serversauf, 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_statsauf, um die Ressourcennutzung in Echtzeit anzuzeigen.„Zeig mir die Logs vom Produktions-Stack“ – ruft
komodo_get_stack_logauf, um die letzten Log-Ausgaben aller Dienste im Stack abzurufen.„Den Frontend-Stack bereitstellen“ – ruft
komodo_deploy_stackauf, um den Stack mit seiner aktuellen Konfiguration erneut bereitzustellen.„Warum ist die Bereitstellung des Frontend-Stacks fehlgeschlagen?“ – ruft
komodo_list_updatesauf, um die fehlgeschlagene Bereitstellung zu finden, und dannkomodo_get_update, um die vollständigen Logs mit stdout/stderr anzuzeigen.„Die neuesten Images für den Monitoring-Stack ziehen“ – ruft
komodo_pull_stackauf, um aktualisierte Images herunterzuladen, ohne erneut bereitzustellen.„Eine neue Deployment-Ressource namens api-staging mit Image myapp:latest erstellen“ – ruft
komodo_write_resourceauf, 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 inspectLizenz
This server cannot be installed
Maintenance
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
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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.
- AlicenseNot gradedqualityFmaintenanceAn 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
- FlicenseCqualityDmaintenanceMCP server that enables deployment and management of MCP servers through a simple configuration-based interface.1
- FlicenseNot gradedqualityCmaintenanceManage 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
Related MCP Connectors
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
MCP server for Appcircle mobile CI/CD platform.
A MCP server built for developers enabling Git based project management with project and personal…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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