de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Related Servers Score Discussions

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.

🤖 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 installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

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 Connectors

microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
daemoon
One PAT, any MCP agent: Vercel, GitHub, Cloudflare, Supabase, GCP — unified dev infra gateway.
Microsoft MCP Server for Enterprise
Official Microsoft MCP Server to query Microsoft Entra data using natural language

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/frizikk/coolify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

🚀 Coolify MCP Server (coolify-mcp)

🌟 ¿Por qué coolify-mcp?