Coolify

Servidor MCP de Coolify

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona cobertura completa de la API REST de Coolify v4.3.1. Administra aplicaciones, bases de datos, servicios, servidores, despliegues y más, todo desde cualquier cliente de IA compatible con MCP.

Compatibilidad: Coolify v4.x. Base de API: https://<your-coolify-instance>/api/v1

Coolify v4.2.0 hizo que los endpoints que cambian el estado fueran solo POST; las rutas GET anteriores ahora devuelven This endpoint has changed to a POST request.. Este servidor emite POST para todos ellos. Las operaciones de ciclo de vida y despliegue siguen siendo compatibles con versiones anteriores de v4.x, que aceptaban ambos métodos. Tres herramientas — enable_api, disable_api y validate_server — llaman a endpoints que eran solo GET antes de v4.2.0 y por lo tanto requieren Coolify v4.2.0 o posterior.

Requisitos previos

• Node.js 18 o superior
• Una instancia de Coolify v4 en ejecución (v4.2.0+ para las tres herramientas mencionadas anteriormente)
• Un token de API de Coolify (desde Seguridad → Tokens de API en el panel de control)

Instalación

# Install globally
npm install -g coolify-mcp-server

# Or use with npx (no install needed)
npx coolify-mcp-server

Configuración

Establece dos variables de entorno:

Variable	Descripción
COOLIFY_BASE_URL	URL base de tu instancia de Coolify (p. ej. https://coolify.example.com)
COOLIFY_TOKEN	Tu token Bearer de la API de Coolify

Configuración de MCP (Claude Desktop / Windsurf / Cline)

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Usuarios de Windows (Cline/cmd):

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Herramientas disponibles

General

• get_version — Obtener la versión de Coolify
• health_check — Verificación de salud de la API (sin autenticación)
• enable_api / disable_api — Habilitar/deshabilitar la API (token raíz)
• enable_mcp / disable_mcp — Habilitar/deshabilitar el endpoint MCP integrado (token raíz)

Equipos

• list_teams, get_team, get_team_members
• get_current_team, get_current_team_members

Servidores

• list_servers, get_server, create_server, update_server, delete_server
• validate_server, get_server_resources, get_server_domains
• create_hetzner_server

Proyectos

• list_projects, get_project, create_project, update_project, delete_project

Entornos

• list_environments, get_environment, create_environment, delete_environment

Aplicaciones

• list_applications, get_application
• create_public_application, create_private_github_app_application, create_private_deploy_key_application
• create_dockerfile_application, create_dockerimage_application
• update_application, delete_application
• start_application, stop_application, restart_application
• get_application_logs
• list_application_envs, create_application_env, update_application_env, bulk_update_application_envs, delete_application_env
• list_application_storages, create_application_storage, delete_application_storage
• list_application_scheduled_tasks, create_application_scheduled_task, delete_application_scheduled_task

Para crear un recurso a partir de un archivo Docker Compose sin procesar, usa create_service con docker_compose_raw. Coolify no tiene un endpoint de creación de compose a nivel de aplicación.

Bases de datos

• list_databases, get_database, update_database, delete_database
• create_postgresql_database, create_mysql_database, create_mariadb_database, create_mongodb_database
• create_redis_database, create_keydb_database, create_dragonfly_database, create_clickhouse_database
• start_database, stop_database, restart_database
• get_database_backups, create_database_backup, list_database_backup_executions
• list_database_envs, create_database_env, delete_database_env

Servicios

• list_services, get_service, create_service, update_service, delete_service
• start_service, stop_service, restart_service
• list_service_envs, create_service_env, delete_service_env
• list_service_scheduled_tasks, create_service_scheduled_task, delete_service_scheduled_task

Despliegues

• list_deployments, get_deployment, cancel_deployment
• list_deployments_by_application, deploy_by_tag_or_uuid

Claves privadas

• list_private_keys, get_private_key, create_private_key, update_private_key, delete_private_key

Aplicaciones de GitHub

• list_github_apps, create_github_app, delete_github_app, list_github_app_repositories

Tokens de nube

• list_cloud_tokens, create_cloud_token, delete_cloud_token

Hetzner

• get_hetzner_locations, get_hetzner_server_types, get_hetzner_images, get_hetzner_ssh_keys
• create_hetzner_server

Recursos

• list_resources — Todos los recursos en la instancia

Licencia

MIT