de en es ja ko ru zh

mcp-komodo

Name: mcp-komodo
Author: Samik081

by Samik081

Overview Schema Related Servers Score Discussions

TypeScript

Remote

npm version License: MIT Node.js Version

MCP Komodo

Servidor MCP para la plataforma DevOps Komodo. Gestiona servidores, stacks, despliegues, builds y mucho más mediante lenguaje natural en Cursor, Claude Code y Claude Desktop.

Características

63 herramientas en 14 categorías que cubren la API completa de Komodo DevOps
Tres niveles de acceso (read-only, read-execute, full) para un control granular
Filtrado por categorías mediante KOMODO_CATEGORIES para exponer solo las herramientas que necesitas
Cero dependencias HTTP -- cliente nativo ligero, sin SDK requerido
Imágenes Docker para linux/amd64 y linux/arm64 en GHCR
MCP remoto mediante transporte HTTP (MCP_TRANSPORT=http) usando el protocolo Streamable HTTP
TypeScript/ESM con seguridad de tipos completa

Related MCP server: komodo-mcp

Compatibilidad de API

Diseñado para Komodo 1.19.5.

Inicio rápido

Ejecuta el servidor directamente con npx:

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

El servidor valida tu conexión con Komodo al iniciar y falla inmediatamente con un error claro si las credenciales faltan o son inválidas.

Docker

Ejecuta con Docker (transporte stdio, igual que 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

Para ejecutar como servidor MCP remoto con transporte HTTP:

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

El endpoint MCP está disponible en http://localhost:3000 y una comprobación de salud en http://localhost:3000/health.

Configuración

CLI de Claude Code (recomendado):

# 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

Config JSON (funciona con .mcp.json de Claude Code, claude_desktop_config.json de Claude Desktop, .cursor/mcp.json de Cursor):

{
  "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"
      ]
    }
  }
}

MCP remoto (conéctate a un contenedor Docker en ejecución o a un servidor HTTP):

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

Niveles de acceso

Controla qué herramientas están disponibles usando la variable de entorno KOMODO_ACCESS_TIER:

Nivel	Herramientas	Descripción
`full` (predeterminado)	63	Leer, ejecutar y escribir -- control total
`read-execute`	55	Leer y ejecutar -- sin creación/eliminación de recursos, sin administración de usuarios
`read-only`	39	Solo lectura -- seguro para exploración, sin cambios de estado

Detalles de los niveles:

full: Las 63 herramientas. Incluye komodo_write_resource para crear, actualizar y eliminar recursos de Komodo, además de las herramientas de administración de usuarios (usuarios de servicio, claves API, permisos).
read-execute: 55 herramientas. Todas las herramientas de lectura más las de ejecución (deploy, pull, lifecycle, run, etc.). La herramienta komodo_write_resource y las herramientas de escritura de administración de usuarios están ocultas.
read-only: 39 herramientas. Solo listar, obtener, logs, inspeccionar, estadísticas, resúmenes, historial de operaciones y lecturas de usuarios/permisos. Todas las herramientas de ejecución y escritura están ocultas.

Las herramientas que no están disponibles en tu nivel no se registran con el servidor MCP. No aparecerán en la lista de herramientas de tu IA, manteniendo el contexto limpio.

Establece KOMODO_ACCESS_TIER a read-only, read-execute o full (predeterminado: full).

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
`KOMODO_URL`	Sí	--	URL de tu instancia de Komodo Core
`KOMODO_API_KEY`	Sí	--	Clave API para autenticación
`KOMODO_API_SECRET`	Sí	--	Secreto API para autenticación
`KOMODO_ACCESS_TIER`	No	`full`	Nivel de acceso: `read-only`, `read-execute` o `full`
`KOMODO_CATEGORIES`	No	(todos)	Lista de categorías permitidas separadas por comas (p. ej., `servers,stacks,builds`)
`KOMODO_TOOL_BLACKLIST`	No	(ninguno)	Lista de nombres de herramientas a excluir separados por comas (p. ej., `komodo_destroy_stack`)
`KOMODO_TOOL_WHITELIST`	No	(ninguno)	Lista de nombres de herramientas a incluir forzosamente, omitiendo los filtros de nivel de acceso y categoría
`DEBUG`	No	`false`	Habilita el registro de depuración en stderr
`MCP_TRANSPORT`	No	`stdio`	Modo de transporte: `stdio` (predeterminado) o `http`
`MCP_PORT`	No	`3000`	Puerto del servidor HTTP (solo se usa cuando `MCP_TRANSPORT=http`)
`MCP_HOST`	No	`0.0.0.0`	Dirección de enlace del servidor HTTP (solo se usa cuando `MCP_TRANSPORT=http`)
`MCP_EXCLUDE_TOOL_TITLES`	No	`false`	Establece `true` para omitir los títulos de las herramientas del registro (ahorra tokens)

Genera claves API en la interfaz de Komodo en Configuración > Claves API.

Categorías disponibles

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

Herramientas

mcp-komodo proporciona 63 herramientas organizadas por categoría. La columna Acceso de cada herramienta muestra el nivel mínimo requerido: read-only (disponible en todos los niveles), read-execute (requiere read-execute o full) o full (requiere solo el nivel full). La columna Pistas muestra el comportamiento de la herramienta: read-only (sin cambios de estado), destructive (modifica el estado existente), idempotent (mismo resultado si se llama dos veces).

Las 16 herramientas de ejecución esperan a que la operación se complete y reportan su resultado real de forma predeterminada; pasa wait: false para fire-and-forget, o wait_timeout_seconds para limitar la espera (predeterminado 45s).

Herramienta	Descripción	Acceso	Pistas
`komodo_list_servers`	Lista todos los servidores con estado y región	read-only	read-only, idempotent
`komodo_get_server`	Obtiene la configuración del servidor, el estado y el estado de la acción	read-only	read-only, idempotent
`komodo_get_server_stats`	Obtiene uso de CPU, memoria, disco y promedios de carga	read-only	read-only, idempotent
`komodo_get_server_info`	Obtiene detalles del SO, información de hardware y procesos en ejecución	read-only	read-only, idempotent
`komodo_inspect_docker_container`	Inspecciona un contenedor Docker (payload de `docker inspect`); los valores de env se muestran como resúmenes `sha256:<12-hex>` a menos que `show_env_values: true` -- el redactado cubre solo los arrays `Env`, por lo que las etiquetas, cmd y mounts se devuelven sin redactar	read-only	read-only, idempotent
`komodo_inspect_docker_image`	Inspecciona una imagen Docker (payload de `docker image inspect`); los valores de env integrados se muestran como resúmenes `sha256:<12-hex>` a menos que `show_env_values: true`; el redactado cubre solo los arrays `Env`, por lo que las etiquetas, cmd y capas se devuelven sin redactar	read-only	read-only, idempotent
`komodo_inspect_docker_network`	Inspecciona una red Docker (equivalente a docker network inspect)	read-only	read-only, idempotent
`komodo_inspect_docker_volume`	Inspecciona un volumen Docker (equivalente a docker volume inspect)	read-only	read-only, idempotent
`komodo_prune_docker`	Poda recursos Docker no utilizados en un servidor	read-execute	destructive, idempotent
`komodo_delete_docker_resource`	Elimina una imagen, volumen o red Docker específica	read-execute	destructive

Tool	Descripción	Acceso	Pistas
`komodo_list_stacks`	Listar todos los stacks con estado, servidor y recuento de servicios	solo lectura	solo lectura, idempotente
`komodo_get_stack`	Obtener la configuración del stack, los servicios y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_list_stack_services`	Listar los servicios en un stack con imagen, estado del contenedor y disponibilidad de actualización	solo lectura	solo lectura, idempotente
`komodo_get_stacks_summary`	Obtener recuentos agregados de todos los stacks por estado	solo lectura	solo lectura, idempotente
`komodo_get_stack_log`	Obtener registros de los servicios del stack, con búsqueda opcional	solo lectura	solo lectura, idempotente
`komodo_inspect_stack_container`	Inspeccionar un contenedor para un servicio específico en un stack (payload de `docker inspect`); los valores de env se muestran como resúmenes `sha256:<12-hex>` a menos que `show_env_values: true` -- la redacción cubre solo los arrays `Env`, por lo que labels, cmd y mounts se devuelven sin redactar	solo lectura	solo lectura, idempotente
`komodo_deploy_stack`	Desplegar o redesplegar un stack	lectura-ejecución	destructivo
`komodo_pull_stack`	Extraer las últimas imágenes sin redesplegar (docker compose pull)	lectura-ejecución	idempotente
`komodo_stack_lifecycle`	Iniciar, detener, reiniciar, pausar o reanudar un stack; opcionalmente se dirige a servicios específicos	lectura-ejecución	destructivo
`komodo_destroy_stack`	Destruir permanentemente un stack	lectura-ejecución	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_list_deployments`	Listar todos los deployments con estado, imagen y servidor	solo lectura	solo lectura, idempotente
`komodo_get_deployment`	Obtener la configuración del deployment, el estado del contenedor y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_get_deployments_summary`	Obtener recuentos agregados de todos los deployments por estado	solo lectura	solo lectura, idempotente
`komodo_get_deployment_log`	Obtener registros del contenedor, con búsqueda opcional	solo lectura	solo lectura, idempotente
`komodo_inspect_deployment_container`	Inspeccionar el contenedor de un deployment (payload de `docker inspect`); los valores de env se muestran como resúmenes `sha256:<12-hex>` a menos que `show_env_values: true` -- la redacción cubre solo los arrays `Env`, por lo que labels, cmd y mounts se devuelven sin redactar	solo lectura	solo lectura, idempotente
`komodo_deploy_deployment`	Desplegar con la última imagen y configuración	lectura-ejecución	destructivo
`komodo_pull_deployment`	Extraer la última imagen sin redesplegar (docker pull)	lectura-ejecución	idempotente
`komodo_deployment_lifecycle`	Iniciar, detener, reiniciar, pausar o reanudar un deployment	lectura-ejecución	destructivo
`komodo_destroy_deployment`	Destruir permanentemente un deployment	lectura-ejecución	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_get_container_log`	Obtener registros de cualquier contenedor Docker en un servidor	solo lectura	solo lectura, idempotente

Tool	Descripción	Acceso	Pistas
`komodo_list_builds`	Listar todas las configuraciones de build con información de versión	solo lectura	solo lectura, idempotente
`komodo_get_build`	Obtener la configuración del build, el builder y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_run_build`	Ejecutar un build para crear una imagen Docker	lectura-ejecución	—
`komodo_cancel_build`	Cancelar un build en ejecución	lectura-ejecución	destructivo, idempotente

Tool	Descripción	Acceso	Pistas
`komodo_list_repos`	Listar todos los repos con URL, servidor y estado	solo lectura	solo lectura, idempotente
`komodo_get_repo`	Obtener la configuración del repo, la rama y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_repo_clone_pull`	Clonar o extraer un repo en su servidor de destino	lectura-ejecución	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_list_procedures`	Listar todos los procedures con estado	solo lectura	solo lectura, idempotente
`komodo_get_procedure`	Obtener las etapas del procedure, las operaciones y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_run_procedure`	Ejecutar un procedure (ejecuta todas las etapas)	lectura-ejecución	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_list_actions`	Listar todas las actions con estado	solo lectura	solo lectura, idempotente
`komodo_get_action`	Obtener la configuración de la action y el estado de la acción	solo lectura	solo lectura, idempotente
`komodo_run_action`	Ejecutar una action personalizada de TypeScript/Deno	lectura-ejecución	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_list_builders`	Listar todos los builders con tipo	solo lectura	solo lectura, idempotente
`komodo_get_builder`	Obtener el tipo del builder, la configuración del servidor y el estado	solo lectura	solo lectura, idempotente

Tool	Descripción	Acceso	Pistas
`komodo_list_alerters`	Listar todos los alerters con tipo	solo lectura	solo lectura, idempotente
`komodo_get_alerter`	Obtener el tipo de endpoint del alerter, la configuración y el estado	solo lectura	solo lectura, idempotente

Tool	Descripción	Acceso	Pistas
`komodo_list_resource_syncs`	Lista todas las sincronizaciones de recursos con estado e información del repositorio	read-only	read-only, idempotent
`komodo_get_resource_sync`	Obtén la configuración de sincronización, los recursos gestionados y el estado	read-only	read-only, idempotent
`komodo_trigger_sync`	Activa una sincronización GitOps desde el repositorio Git	read-execute	destructivo

Tool	Descripción	Acceso	Pistas
`komodo_list_updates`	Lista el historial de operaciones con filtros por tipo de recurso, objetivo, operación y éxito	read-only	read-only, idempotent
`komodo_get_update`	Obtén los detalles completos de la operación, incluidos los registros con stdout/stderr de cada etapa	read-only	read-only, idempotent

Las 10 herramientas de usuario requieren una cuenta de administrador de Komodo: Komodo las rechaza para claves de API que no sean de administrador, independientemente del nivel de acceso configurado.

Tool	Descripción	Acceso	Pistas
`komodo_list_users`	Lista los usuarios de Komodo, opcionalmente filtrando usuarios de servicio	read-only	read-only, idempotent
`komodo_list_api_keys_for_service_user`	Lista las claves de API de un usuario de servicio (los secretos nunca se devuelven)	read-only	read-only, idempotent
`komodo_list_permissions`	Lista los permisos otorgados a un usuario o grupo de usuarios	read-only	read-only, idempotent
`komodo_create_service_user`	Crea un usuario de servicio para automatización	full	—
`komodo_delete_user`	Elimina un usuario por ID o nombre de usuario	full	destructivo
`komodo_create_api_key_for_service_user`	Crea una clave de API para un usuario de servicio (el secreto se devuelve una sola vez)	full	—
`komodo_delete_api_key_for_service_user`	Elimina la clave de API de un usuario de servicio	full	destructivo
`komodo_update_user_base_permissions`	Actualiza los indicadores de habilitado / crear-servidores / crear-compilaciones de un usuario	full	destructivo, idempotent
`komodo_update_permission_on_resource_type`	Establece el permiso base de un usuario o grupo en todos los recursos de un tipo	full	destructivo, idempotent
`komodo_update_permission_on_target`	Establece el permiso de un usuario o grupo en un recurso específico	full	destructivo, idempotent

Tool	Descripción	Acceso	Pistas
`komodo_write_resource`	Crea, actualiza o elimina cualquier recurso de Komodo	full	destructivo

Verifica que funciona

Después de configurar tu cliente MCP, pregúntale a tu asistente de IA:

"¿Qué servidores están conectados a Komodo?"

Si la conexión funciona, el asistente llamará a komodo_list_servers y devolverá tus servidores con su estado y región actuales.

Ejemplos de uso

Una vez configurado, haz preguntas a tu herramienta de IA en lenguaje natural:

"Lista todos mis servidores y su estado" -- llama a komodo_list_servers para mostrar cada servidor con su estado y región actuales.
"¿Cuál es el uso de CPU y memoria en el servidor prod-01?" -- llama a komodo_get_server_stats para mostrar la utilización de recursos en tiempo real.
"Muéstrame los registros de la pila de producción" -- llama a komodo_get_stack_log para recuperar la salida de registros reciente de todos los servicios de la pila.
"Despliega la pila frontend" -- llama a komodo_deploy_stack para volver a desplegar la pila con su configuración actual.
"¿Por qué falló el despliegue de la pila frontend?" -- llama a komodo_list_updates para encontrar el despliegue fallido, luego a komodo_get_update para mostrar los registros completos con stdout/stderr.
"Descarga las últimas imágenes para la pila de monitoreo" -- llama a komodo_pull_stack para descargar imágenes actualizadas sin volver a desplegar.
"Crea un nuevo despliegue llamado api-staging con la imagen myapp:latest" -- llama a komodo_write_resource para crear un nuevo recurso de Deployment en Komodo.

Solución de problemas

Conexión rechazada

Comprueba que KOMODO_URL es correcta y que Komodo Core es accesible desde donde se ejecuta el servidor MCP. El servidor valida la conexión al iniciarse, por lo que si se inició correctamente, la URL era válida en ese momento.

Credenciales no válidas / 401 No autorizado

Verifica que tu clave de API y secreto son correctos. Comprueba que la clave no ha sido revocada o expirada en la interfaz de Komodo en Configuración > Claves de API.

Las herramientas no aparecen

Comprueba tu configuración de nivel de acceso. En el modo read-only, solo se registran 39 herramientas. En el modo read-execute, se registran 55 herramientas. Usa full (u omite KOMODO_ACCESS_TIER) para las 63 herramientas. Comprueba KOMODO_CATEGORIES: solo se registran las herramientas de las categorías listadas. También verifica que el servidor se inició sin errores revisando la salida de stderr.

Desarrollo

# 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

Licencia

MIT

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

25Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

Komodo MCP Server
CI/CD & DevOps Monitoring Cloud Platforms
Secure-ISS
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.
Updated 7 months ago (2026-01-26 23:08 UTC)
komodo-mcp
Virtualization Cloud Platforms Developer Tools
digital-grease
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.
Updated 5 months ago (2026-03-29 02:57 UTC)
MIT
mcpdeployment
Developer Tools Agent Orchestration
manutrip-pm-AI-Defense
F
license
C
quality
D
maintenance
MCP server that enables deployment and management of MCP servers through a simple configuration-based interface.
Updated 3 months ago (2026-05-19 09:38 UTC)
1
komodo-mcp
Cloud Platforms Virtualization CI/CD & DevOps
MyrikLD
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.
Updated 16 days ago (2026-08-07 13:09 UTC)
13

View all related MCP servers

Related MCP Connectors

Azure DevOps (ADO)
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Appcircle MCP
MCP server for Appcircle mobile CI/CD platform.
neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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