Servidor MCP de Coolify

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración con la API de Coolify. Este servidor permite la interacción con instancias de Coolify mediante herramientas MCP.

Compatibilidad: Probado con Coolify versión 4.0.0-beta.397

Prerrequisitos

Node.js 18 o superior
URL base de Coolify
Token de API de Coolify

Características

Gestión de equipos (lista, obtener detalles, miembros)
Gestión de servidores (crear, validar, recursos, dominios)
Gestión del ciclo de vida del servicio (inicio, detención, reinicio)
Gestión del ciclo de vida de la aplicación (iniciar, detener, reiniciar, ejecutar comandos)
Seguimiento de la implementación
Gestión de claves privadas
Comprobaciones de versión y estado

Instalación

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

# Or use with npx
npx coolify-mcp-server

Configuración

El servidor requiere dos variables de entorno:

COOLIFY_BASE_URL : La URL base de su instancia de Coolify
COOLIFY_TOKEN : Su token de API de Coolify

Obtener un token de API

Vaya a su instancia de Coolify
Vaya a Keys & Tokens / API tokens
Cree un nuevo token con los siguientes permisos requeridos:
- leer (para obtener información)
- escribir (para gestionar recursos)
- implementar (para operaciones de implementación)

Uso

En la configuración de MCP

Agregue lo siguiente a la configuración de su MCP:

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Los usuarios de Windows Cline pueden necesitar lo siguiente:

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

Herramientas disponibles

Versión y salud

get_version : Obtener información de la versión de Coolify
health_check : Verificar el estado de salud de la API de Coolify

Equipos

list_teams : Lista todos los equipos
get_team : Obtener detalles de un equipo específico
get_current_team : Obtener los detalles actuales del equipo
get_current_team_members : Obtener los miembros actuales del equipo

Servidores

list_servers : Lista todos los servidores
create_server : Crea un nuevo servidor
validate_server : Validar la configuración del servidor
get_server_resources : Obtener el uso de los recursos del servidor
get_server_domains : Obtener dominios del servidor

Servicios

list_services : Lista todos los servicios
create_service : Crea un nuevo servicio
start_service : Iniciar un servicio
stop_service : Detener un servicio
restart_service : Reiniciar un servicio

Aplicaciones

list_applications : Lista todas las aplicaciones
create_application : Crea una nueva aplicación
start_application : Iniciar una aplicación
stop_application : Detener una aplicación
restart_application : Reiniciar una aplicación
execute_command_application : Ejecutar comando en el contenedor de la aplicación

Despliegues

list_deployments : Lista todas las implementaciones
get_deployment : Obtener detalles de la implementación

Claves privadas

list_private_keys : Lista todas las claves privadas
create_private_key : Crea una nueva clave privada

Licencia

Instituto Tecnológico de Massachusetts (MIT)