Skip to content

Full Model Context Protocol (MCP) server for Komodo API. Manage servers, stacks, deployments, and procedures directly from your AI assistant. Docker-ready

Notifications You must be signed in to change notification settings

Nonetss/komodo-mcp

Repository files navigation

Komodo MCP Server

Un servidor MCP (Model Context Protocol) completo para la API de Komodo. Proporciona acceso a todas las funcionalidades de Komodo a través de una arquitectura modular y bien estructurada.

🚀 Despliegue Rápido (Docker Compose)

La forma más sencilla de ejecutar este servidor es utilizando Docker Compose con la imagen pre-construida.

  1. Crea un archivo docker-compose.yml:
version: '3.8'

services:
  komodo-mcp:
    image: ghcr.io/nonetss/komodo-mcp:latest
    container_name: komodo-mcp-server
    ports:
      - "3333:3333"
      - "8090:8090"
    environment:
      - KOMODO_URL=${KOMODO_URL}
      - KOMODO_KEY=${KOMODO_KEY}
      - KOMODO_SECRET=${KOMODO_SECRET}
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3333/sse"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
  1. Crea un archivo .env:
KOMODO_URL=https://tu-instancia.komo.do
KOMODO_KEY=tu_api_key
KOMODO_SECRET=tu_secret
  1. Inicia el servidor:
docker compose up -d
  1. Verifica la conexión:
curl http://localhost:3333/sse

🛠️ Herramientas Disponibles

El servidor MCP proporciona 40+ herramientas organizadas en los siguientes módulos:

🖥️ Servidores

  • list_servers, get_server_info, create_server, update_server, delete_server, get_server_stats

📚 Stacks

  • list_stacks, get_stack_info, deploy_stack, create_stack, update_stack, delete_stack, start_stack, stop_stack, restart_stack

🚀 Deployments

  • list_deployments, get_deployment_info, deploy_deployment, create_deployment, update_deployment, delete_deployment, start_deployment, stop_deployment, restart_deployment, get_deployment_logs

🔨 Builds

  • list_builds, get_build_info, run_build, create_build, update_build, delete_build, cancel_build

📁 Repositorios

  • list_repos, get_repo_info, create_repo, update_repo, delete_repo, pull_repo, clone_repo

⚙️ Procedimientos

  • list_procedures, get_procedure_info, run_procedure, create_procedure, update_procedure, delete_procedure

🔧 Sistema

  • list_updates, get_system_info, get_version, list_alerters, get_alerter_info, create_alerter, update_alerter, delete_alerter

🏗️ Desarrollo Local

Si deseas contribuir o modificar el código:

  1. Instala dependencias: pnpm install
  2. Desarrollo: pnpm dev
  3. Construir: pnpm build

🔗 Enlaces

About

Full Model Context Protocol (MCP) server for Komodo API. Manage servers, stacks, deployments, and procedures directly from your AI assistant. Docker-ready

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages