de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🚀 Coolify MCP Server (`coolify-mcp`)

TypeScript Node Version License: MIT Model Context Protocol Coolify API Tools

Un servidor Model Context Protocol (MCP) integral y de nivel de producción para Coolify v4 PaaS autoalojado.

Conecta asistentes y agentes de codificación con IA (Claude Desktop, Cursor, Antigravity, Claude Code, Windsurf, Cline y VS Code) directamente a tu instancia de Coolify para orquestar infraestructura, desplegar aplicaciones, gestionar 8 tipos de bases de datos, manejar variables de entorno y diagnosticar registros mediante lenguaje natural.

🌟 ¿Por qué `coolify-mcp`?

🌐 100% de cobertura de la API de Coolify v4: 77 herramientas MCP verificadas que cubren Proyectos, Entornos, Servidores, Aplicaciones, Bases de Datos, Servicios Docker Compose, Despliegues, Miembros del Equipo y Claves SSH.
🔒 Protección de solo lectura: Activa --read-only (o COOLIFY_READ_ONLY=true) para permitir que los asistentes de IA auditen, supervisen y solucionen problemas sin acciones mutadoras ni destructivas.
🗄️ Soporte universal de motores de bases de datos: Creación y configuración listas para usar de PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly y KeyDB con normalización de parámetros específica del motor.
📊 Recursos MCP dinámicos: Recursos nativos (coolify://overview, coolify://servers, coolify://applications, coolify://databases) para contexto ambiental de cero tokens.
💡 Plantillas de prompt de DevOps: Recetas de prompt predefinidas (diagnose-application, infrastructure-audit, deployment-summary) para diagnósticos autónomos y comprobaciones de salud.
🐳 Listo para transporte Docker y Stdio: Ejecútalo como una herramienta CLI estándar de Node o dentro de contenedores Docker aislados con soporte de red contenedor a contenedor.

Related MCP server: Coolify MCP Server

🤖 Prompt de configuración del agente de IA (Copiar y pegar)

Si estás usando un asistente de codificación con IA (como Antigravity, Claude Code, Cursor, Windsurf o Cline), simplemente copia y pega el siguiente prompt en tu asistente:

Please configure and set up the Coolify MCP server for me from https://github.com/frizikk/coolify-mcp.git.

Follow these steps:
1. Clone the repository:
   git clone https://github.com/frizikk/coolify-mcp.git
2. Install dependencies and build the server:
   cd coolify-mcp && pnpm install && pnpm build
3. Guide me to provide my Coolify instance URL (e.g. https://coolify.my-domain.com or http://localhost:8000) and API Bearer Token (generated in Coolify under Keys & Tokens / Settings -> API).
4. Add the `coolify` server configuration to my MCP client config (e.g., in Claude Desktop `claude_desktop_config.json`, Cursor `~/.cursor/mcp.json`, or Antigravity `~/.gemini/config/mcp_config.json`).
5. Test the connection by calling `coolify_get_version` and `coolify_get_infrastructure_overview` to verify connection to my Coolify instance.

🛠️ Referencia de herramientas MCP

El servidor expone 77 herramientas especializadas organizadas en 8 dominios principales de DevOps:

1. Resumen del sistema e infraestructura (4 herramientas)

Tool	Parameters	Description
`coolify_get_version`	none	Obtiene la cadena de versión de la instancia de Coolify en ejecución.
`coolify_get_health`	none	Realiza una comprobación de salud del backend de Coolify.
`coolify_list_resources`	none	Lista todos los recursos gestionados en todos los proyectos.
`coolify_get_infrastructure_overview`	none	Obtiene un panel agregado de salud, estado del servidor, aplicaciones y bases de datos.

2. Gestión de servidores y nodos (8 herramientas)

Tool	Parameters	Description
`coolify_list_servers`	none	Lista todos los servidores registrados con indicadores de accesibilidad y usabilidad.
`coolify_get_server`	`uuid`	Obtiene la configuración detallada del servidor, la IP y los ajustes.
`coolify_validate_server`	`uuid`	Valida la conexión SSH y la conectividad con un servidor.
`coolify_get_server_resources`	`uuid`	Lista todos los recursos desplegados en un servidor específico.
`coolify_get_server_domains`	`uuid`	Lista todos los dominios y rutas activos en un servidor.
`coolify_create_server`	`name`, `ip`, `port?`, `user?`, `private_key_uuid?`, `proxy_type?`	Registra un nuevo nodo de servidor.
`coolify_update_server`	`uuid`, `name?`, `description?`, `ip?`, `port?`	Actualiza la configuración del servidor.
`coolify_delete_server`	`uuid`	Elimina un servidor de Coolify.

3. Equipos y claves SSH (9 herramientas)

Tool	Parameters	Description
`coolify_list_teams`	none	Lista todos los equipos accesibles mediante token.
`coolify_get_current_team`	none	Obtiene los detalles del equipo autenticado activo.
`coolify_get_current_team_members`	none	Lista usuarios y roles del equipo activo.
`coolify_get_team`	`team_id`	Obtiene los detalles del equipo por ID.
`coolify_get_team_members`	`team_id`	Lista los miembros de un equipo específico por ID.
`coolify_list_private_keys`	none	Lista todas las claves privadas SSH registradas.
`coolify_get_private_key`	`uuid`	Obtiene los detalles de la clave privada.
`coolify_create_private_key`	`name`, `private_key`, `description?`	Registra una nueva clave privada SSH (Ed25519/RSA).
`coolify_delete_private_key`	`uuid`	Elimina una clave privada SSH.

4. Proyectos y entornos (9 herramientas)

Tool	Parameters	Description
`coolify_list_projects`	none	Lista todos los proyectos y entornos.
`coolify_get_project`	`uuid`	Obtiene la estructura del proyecto y la lista de entornos.
`coolify_create_project`	`name`, `description?`	Crea un nuevo proyecto.
`coolify_update_project`	`uuid`, `name?`, `description?`	Actualiza el nombre o la descripción del proyecto.
`coolify_delete_project`	`uuid`	Elimina un proyecto vacío.
`coolify_list_environments`	`project_uuid`	Lista los entornos de un proyecto.
`coolify_get_environment`	`project_uuid`, `environment_name_or_uuid`	Obtiene los detalles del entorno.
`coolify_create_environment`	`project_uuid`, `name`	Crea un nuevo entorno (`testing`, `staging`).
`coolify_delete_environment`	`project_uuid`, `environment_name_or_uuid`	Elimina un entorno.

5. Aplicaciones (16 herramientas)

Herramienta	Parámetros	Descripción
`coolify_list_applications`	ninguno	Listar todas las aplicaciones independientes.
`coolify_get_application`	`uuid`	Obtener la configuración de la aplicación, los puertos y los dominios.
`coolify_create_application_public_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `build_pack`, `name?`	Desplegar desde un repositorio Git público.
`coolify_create_application_private_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `private_key_uuid`, `build_pack`, `name?`	Desplegar desde un repositorio Git privado.
`coolify_create_application_dockerfile`	`project_uuid`, `server_uuid`, `environment_name`, `dockerfile`, `name?`	Desplegar desde un Dockerfile sin procesar o en base64.
`coolify_create_application_docker_image`	`project_uuid`, `server_uuid`, `environment_name`, `docker_registry_image_name`, `docker_registry_image_tag?`	Desplegar una imagen Docker preconstruida.
`coolify_update_application`	`uuid`, `name?`, `description?`, `domains?`, `build_pack?`, `ports_exposes?`	Actualizar la configuración de la aplicación.
`coolify_delete_application`	`uuid`	Eliminar la aplicación y sus contenedores.
`coolify_start_application`	`uuid`	Activar el inicio / despliegue de la aplicación.
`coolify_stop_application`	`uuid`	Detener el contenedor de la aplicación en ejecución.
`coolify_restart_application`	`uuid`	Reiniciar el contenedor de la aplicación.
`coolify_get_application_logs`	`uuid`	Obtener los registros stdout/stderr del contenedor en tiempo de ejecución.
`coolify_list_application_envs`	`uuid`	Listar todas las variables de entorno de la aplicación.
`coolify_set_application_env`	`uuid`, `key`, `value`, `is_build_time?`, `is_literal?`	Establecer / crear variable de entorno.
`coolify_bulk_set_application_envs`	`uuid`, `envs: [{key, value}]`	Actualizar de forma masiva varias variables de entorno.
`coolify_delete_application_env`	`uuid`, `env_uuid`	Eliminar una variable de entorno por UUID.

6. Despliegues (5 herramientas)

Herramienta	Parámetros	Descripción
`coolify_list_deployments`	ninguno	Listar los despliegues globales en ejecución y completados.
`coolify_list_app_deployments`	`app_uuid`	Listar el historial de despliegues de una aplicación específica.
`coolify_get_deployment`	`deployment_uuid`	Obtener el estado del despliegue, la información del commit y los registros.
`coolify_trigger_deployment`	`uuid?`, `tag?`, `force?`	Activar una construcción y un despliegue instantáneos.
`coolify_cancel_deployment`	`deployment_uuid`	Cancelar un despliegue en curso.

7. Bases de datos (14 herramientas)

Herramienta	Parámetros	Descripción
`coolify_list_databases`	ninguno	Listar todas las bases de datos independientes.
`coolify_get_database`	`uuid`	Obtener los detalles de la base de datos y las cadenas de conexión.
`coolify_create_database`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `database_name?`, `database_user?`, `database_password?`, `root_password?`, `is_public?`	Crear una base de datos (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB).
`coolify_update_database`	`uuid`, `name?`, `description?`, `is_public?`, `public_port?`	Actualizar la configuración de la base de datos.
`coolify_delete_database`	`uuid`	Eliminar el contenedor y el volumen de la base de datos.
`coolify_start_database`	`uuid`	Iniciar el contenedor de la base de datos.
`coolify_stop_database`	`uuid`	Detener el contenedor de la base de datos.
`coolify_restart_database`	`uuid`	Reiniciar el contenedor de la base de datos.
`coolify_get_database_backups`	`uuid`	Listar las configuraciones de copia de seguridad de la base de datos.
`coolify_create_database_backup`	`uuid`, `frequency`, `enabled?`, `save_s3?`	Programar copias de seguridad automáticas de la base de datos (cron).
`coolify_update_database_backup`	`uuid`, `backup_uuid`, `frequency?`, `enabled?`	Actualizar la configuración de la programación de copias de seguridad.
`coolify_delete_database_backup`	`uuid`, `backup_uuid`	Eliminar la configuración de copia de seguridad.
`coolify_list_backup_executions`	`uuid`, `backup_uuid`	Listar el historial de ejecuciones de las copias de seguridad.
`coolify_delete_backup_execution`	`uuid`, `backup_uuid`, `execution_uuid`	Eliminar un artefacto de ejecución de copia de seguridad específico.

8. Servicios de un clic y Docker Compose (12 herramientas)

Herramienta	Parámetros	Descripción
`coolify_list_services`	ninguno	Lista todos los servicios de un clic.
`coolify_get_service`	`uuid`	Obtiene metadatos del servicio, dominios y contenedores.
`coolify_create_service`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `description?`	Despliega plantilla de un clic (Ghost, Plausible, etc.).
`coolify_update_service`	`uuid`, `name?`, `description?`	Actualiza la configuración del servicio.
`coolify_delete_service`	`uuid`	Elimina la pila de servicios.
`coolify_start_service`	`uuid`	Inicia los contenedores del servicio.
`coolify_stop_service`	`uuid`	Detiene los contenedores del servicio.
`coolify_restart_service`	`uuid`	Reinicia la pila de servicios.
`coolify_list_service_envs`	`uuid`	Lista las variables de entorno del servicio.
`coolify_set_service_env`	`uuid`, `key`, `value`	Crea/actualiza la variable de entorno del servicio.
`coolify_bulk_set_service_envs`	`uuid`, `envs: [{key, value}]`	Actualiza en bloque las variables de entorno del servicio.
`coolify_delete_service_env`	`uuid`, `env_uuid`	Elimina una variable de entorno del servicio.

📊 Recursos y Prompts de MCP

Recursos

coolify://overview — Resumen agregado en tiempo real de todos los servidores, aplicaciones, bases de datos y servicios.
coolify://servers — Lista en vivo de servidores y estado de accesibilidad.
coolify://applications — Estado en vivo de todas las aplicaciones y URLs.
coolify://databases — Estado en vivo de los contenedores de bases de datos.

Prompts

diagnose-application — Flujo de trabajo de diagnóstico automatizado: comprueba el estado de la aplicación, analiza registros recientes e inspecciona las variables de entorno.
infrastructure-audit — Verificación completa de la salud de la infraestructura en servidores, límites de disco y contenedores fallidos.
deployment-summary — Analiza despliegues recientes y muestra fallos de compilación.

⚙️ Configuración y Preparación del Cliente

Variables de Entorno

Variable	Descripción	Por defecto
`COOLIFY_BASE_URL`	URL base de tu instancia de Coolify (p. ej. `https://coolify.example.com`)	`http://localhost:8000`
`COOLIFY_API_TOKEN`	Token Bearer de la API de Coolify	`""`
`COOLIFY_READ_ONLY`	Restringir a acciones no mutables (`true`/`false`)	`false`

Ejemplos de Configuración del Cliente

1. Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

2. Cursor (`~/.cursor/mcp.json` o `.cursor/mcp.json` del proyecto)

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

3. Antigravity (`~/.gemini/config/mcp_config.json`)

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

4. Modo Contenedor Docker

docker run -i --rm \
  -e COOLIFY_BASE_URL="http://coolify:8080" \
  -e COOLIFY_API_TOKEN="your-bearer-token" \
  --network coolify-network \
  coolify-mcp:latest

🧪 Pruebas y Verificación

El conjunto de pruebas incluye pruebas unitarias y pruebas de integración de extremo a extremo ejecutadas contra una instancia en vivo de Coolify v4 en Docker:

# Run all automated unit and integration tests (43 tests)
pnpm test

# Run complete 77-tool live verification suite
pnpm test:verify-live

📄 Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para más detalles.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp
JustDeployOAuth
ai.justdeploy
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Cloud Platforms CI/CD & DevOps App Automation
2
https://mcp.justdeploy.ai/mcp
microservices.sh
sh.microservices
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Cloud Platforms Agent Orchestration Developer Tools
21
https://api.microservices.sh/mcp
serverOAuth
com.devopness.mcp
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
Cloud Platforms CI/CD & DevOps Developer Tools
3
https://mcp.devopness.com/mcp/

Related MCP Servers

Coolify MCP Server
Cloud Platforms Developer Tools Virtualization
kof70
A
license
B
quality
B
maintenance
Enables control and management of Coolify self-hosted PaaS instances, allowing you to deploy applications, manage databases, monitor servers, and execute operations directly from AI assistants.
Updated a month ago (2026-09-17 18:56 UTC)
89
9 npm
28
MIT
Coolify MCP Server
Cloud Platforms CI/CD & DevOps Developer Tools
JoshuaRileyDev
A
license
B
quality
D
maintenance
Enables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.
Updated a year ago (2025-06-15 17:53 UTC)
18
6 npm
3
MIT
coolify-mcp
Cloud Platforms Databases
jurislm
A
license
Not graded
quality
F
maintenance
MCP server for Coolify infrastructure management, providing 45 tools for servers, applications, databases, deployments, and diagnostics via natural language.
Updated 4 months ago (2026-07-11 05:18 UTC)
32 npm
MIT
coolify-mcp
Cloud Platforms Developer Tools CI/CD & DevOps
0xtlt
A
license
B
quality
A
maintenance
MCP server for managing Coolify instances, enabling control of applications, databases, services, servers, and more via natural language.
Updated 7 days ago (2026-10-22 05:30 UTC)
136
197 npm
MIT

🚀 Coolify MCP Server (coolify-mcp)

🌟 ¿Por qué coolify-mcp?