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

Комплексный production-grade сервер Model Context Protocol (MCP) для self-hosted PaaS Coolify v4.

Подключайте ИИ-ассистентов и агентов для написания кода (Claude Desktop, Cursor, Antigravity, Claude Code, Windsurf, Cline и VS Code) напрямую к вашему экземпляру Coolify, чтобы оркестрировать инфраструктуру, разворачивать приложения, управлять 8 типами баз данных, работать с переменными окружения и диагностировать логи на естественном языке.

🌟 Почему `coolify-mcp`?

🌐 100% полное покрытие API Coolify v4: 77 проверенных MCP-инструментов, покрывающих проекты, окружения, серверы, приложения, базы данных, Docker Compose-сервисы, деплои, участников команд и SSH-ключи.
🔒 Защитный режим «только чтение»: Включите --read-only (или COOLIFY_READ_ONLY=true), чтобы ИИ-ассистенты могли проводить аудит, мониторинг и устранение неполадок без каких-либо изменяющих или разрушающих действий.
🗄️ Поддержка универсальных движков баз данных: Создание и настройка «из коробки» для PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly и KeyDB с нормализацией параметров для каждого движка.
📊 Динамические MCP-ресурсы: Нативные ресурсы (coolify://overview, coolify://servers, coolify://applications, coolify://databases) для фонового контекста без затрат токенов.
💡 Шаблоны DevOps-промптов: Готовые рецепты промптов (diagnose-application, infrastructure-audit, deployment-summary) для автономной диагностики и проверок работоспособности.
🐳 Готовность к Docker и stdio-транспорту: Запуск в качестве стандартного Node.js CLI-инструмента или внутри изолированных Docker-контейнеров с поддержкой сетевого взаимодействия между контейнерами.

Related MCP server: Coolify MCP Server

🤖 Промпт для настройки ИИ-агента (копировать и вставить)

Если вы используете ИИ-ассистента для разработки (например, Antigravity, Claude Code, Cursor, Windsurf или Cline), просто скопируйте и вставьте приведенный ниже промпт в своего ассистента:

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.

🛠️ Справочник MCP-инструментов

Сервер предоставляет 77 специализированных инструментов, сгруппированных по 8 ключевым DevOps-областям:

1. Обзор системы и инфраструктуры (4 инструмента)

Инструмент	Параметры	Описание
`coolify_get_version`	нет	Получить строку версии запущенного экземпляра Coolify.
`coolify_get_health`	нет	Выполнить проверку работоспособности бэкенда Coolify.
`coolify_list_resources`	нет	Вывести список всех ресурсов, управляемых во всех проектах.
`coolify_get_infrastructure_overview`	нет	Получить сводную панель с агрегированными данными о работоспособности, статусе серверов, приложений и баз данных.

2. Управление серверами и узлами (8 инструментов)

Инструмент	Параметры	Описание
`coolify_list_servers`	нет	Вывести список всех зарегистрированных серверов с флагами доступности и пригодности.
`coolify_get_server`	`uuid`	Получить подробную конфигурацию сервера, IP-адрес и настройки.
`coolify_validate_server`	`uuid`	Проверить SSH-подключение и связь с сервером.
`coolify_get_server_resources`	`uuid`	Вывести список всех ресурсов, развернутых на конкретном сервере.
`coolify_get_server_domains`	`uuid`	Вывести список всех активных доменов и маршрутов на сервере.
`coolify_create_server`	`name`, `ip`, `port?`, `user?`, `private_key_uuid?`, `proxy_type?`	Зарегистрировать новый серверный узел.
`coolify_update_server`	`uuid`, `name?`, `description?`, `ip?`, `port?`	Обновить конфигурацию сервера.
`coolify_delete_server`	`uuid`	Удалить сервер из Coolify.

3. Команды и SSH-ключи (9 инструментов)

Инструмент	Параметры	Описание
`coolify_list_teams`	нет	Вывести список всех команд, доступных по токену.
`coolify_get_current_team`	нет	Получить данные активной аутентифицированной команды.
`coolify_get_current_team_members`	нет	Вывести список пользователей и ролей в активной команде.
`coolify_get_team`	`team_id`	Получить данные команды по ID.
`coolify_get_team_members`	`team_id`	Вывести список участников конкретной команды по ID.
`coolify_list_private_keys`	нет	Вывести список всех зарегистрированных SSH-приватных ключей.
`coolify_get_private_key`	`uuid`	Получить данные приватного ключа.
`coolify_create_private_key`	`name`, `private_key`, `description?`	Зарегистрировать новый SSH-приватный ключ (Ed25519/RSA).
`coolify_delete_private_key`	`uuid`	Удалить SSH-приватный ключ.

4. Проекты и окружения (9 инструментов)

Инструмент	Параметры	Описание
`coolify_list_projects`	нет	Вывести список всех проектов и окружений.
`coolify_get_project`	`uuid`	Получить структуру проекта и список окружений.
`coolify_create_project`	`name`, `description?`	Создать новый проект.
`coolify_update_project`	`uuid`, `name?`, `description?`	Обновить название или описание проекта.
`coolify_delete_project`	`uuid`	Удалить пустой проект.
`coolify_list_environments`	`project_uuid`	Вывести список окружений в проекте.
`coolify_get_environment`	`project_uuid`, `environment_name_or_uuid`	Получить данные окружения.
`coolify_create_environment`	`project_uuid`, `name`	Создать новое окружение (`testing`, `staging`).
`coolify_delete_environment`	`project_uuid`, `environment_name_or_uuid`	Удалить окружение.

5. Приложения (16 инструментов)

Инструмент	Параметры	Описание
`coolify_list_applications`	нет	Получить список всех автономных приложений.
`coolify_get_application`	`uuid`	Получить конфигурацию приложения, порты и домены.
`coolify_create_application_public_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `build_pack`, `name?`	Развернуть из публичного Git-репозитория.
`coolify_create_application_private_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `private_key_uuid`, `build_pack`, `name?`	Развернуть из приватного Git-репозитория.
`coolify_create_application_dockerfile`	`project_uuid`, `server_uuid`, `environment_name`, `dockerfile`, `name?`	Развернуть из Dockerfile в формате raw или base64.
`coolify_create_application_docker_image`	`project_uuid`, `server_uuid`, `environment_name`, `docker_registry_image_name`, `docker_registry_image_tag?`	Развернуть предварительно собранный Docker-образ.
`coolify_update_application`	`uuid`, `name?`, `description?`, `domains?`, `build_pack?`, `ports_exposes?`	Обновить конфигурацию приложения.
`coolify_delete_application`	`uuid`	Удалить приложение и его контейнеры.
`coolify_start_application`	`uuid`	Инициировать запуск/развертывание приложения.
`coolify_stop_application`	`uuid`	Остановить запущенный контейнер приложения.
`coolify_restart_application`	`uuid`	Перезапустить контейнер приложения.
`coolify_get_application_logs`	`uuid`	Получить журналы stdout/stderr контейнера во время выполнения.
`coolify_list_application_envs`	`uuid`	Получить список всех переменных окружения приложения.
`coolify_set_application_env`	`uuid`, `key`, `value`, `is_build_time?`, `is_literal?`	Установить/создать переменную окружения.
`coolify_bulk_set_application_envs`	`uuid`, `envs: [{key, value}]`	Массово обновить несколько переменных окружения.
`coolify_delete_application_env`	`uuid`, `env_uuid`	Удалить переменную окружения по UUID.

6. Развертывания (5 инструментов)

Инструмент	Параметры	Описание
`coolify_list_deployments`	нет	Получить список всех выполняющихся и завершенных развертываний.
`coolify_list_app_deployments`	`app_uuid`	Получить историю развертываний для конкретного приложения.
`coolify_get_deployment`	`deployment_uuid`	Получить статус развертывания, информацию о коммите и журналы.
`coolify_trigger_deployment`	`uuid?`, `tag?`, `force?`	Запустить немедленную сборку и развертывание.
`coolify_cancel_deployment`	`deployment_uuid`	Отменить выполняющееся развертывание.

7. Базы данных (14 инструментов)

Инструмент	Параметры	Описание
`coolify_list_databases`	нет	Получить список всех автономных баз данных.
`coolify_get_database`	`uuid`	Получить информацию о базе данных и строки подключения.
`coolify_create_database`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `database_name?`, `database_user?`, `database_password?`, `root_password?`, `is_public?`	Создать базу данных (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB).
`coolify_update_database`	`uuid`, `name?`, `description?`, `is_public?`, `public_port?`	Обновить настройки базы данных.
`coolify_delete_database`	`uuid`	Удалить контейнер и том базы данных.
`coolify_start_database`	`uuid`	Запустить контейнер базы данных.
`coolify_stop_database`	`uuid`	Остановить контейнер базы данных.
`coolify_restart_database`	`uuid`	Перезапустить контейнер базы данных.
`coolify_get_database_backups`	`uuid`	Получить список конфигураций резервного копирования для базы данных.
`coolify_create_database_backup`	`uuid`, `frequency`, `enabled?`, `save_s3?`	Запланировать автоматическое резервное копирование базы данных (cron).
`coolify_update_database_backup`	`uuid`, `backup_uuid`, `frequency?`, `enabled?`	Обновить настройки расписания резервного копирования.
`coolify_delete_database_backup`	`uuid`, `backup_uuid`	Удалить конфигурацию резервного копирования.
`coolify_list_backup_executions`	`uuid`, `backup_uuid`	Получить историю выполнения резервного копирования.
`coolify_delete_backup_execution`	`uuid`, `backup_uuid`, `execution_uuid`	Удалить конкретный артефакт выполнения резервного копирования.

8. Сервисы в один клик и Docker Compose (12 инструментов)

Tool	Параметры	Описание
`coolify_list_services`	нет	Перечислить все сервисы в один клик.
`coolify_get_service`	`uuid`	Получить метаданные сервиса, домены и контейнеры.
`coolify_create_service`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `description?`	Развернуть шаблон в один клик (Ghost, Plausible и т. д.).
`coolify_update_service`	`uuid`, `name?`, `description?`	Обновить настройки сервиса.
`coolify_delete_service`	`uuid`	Удалить стек сервиса.
`coolify_start_service`	`uuid`	Запустить контейнеры сервиса.
`coolify_stop_service`	`uuid`	Остановить контейнеры сервиса.
`coolify_restart_service`	`uuid`	Перезапустить стек сервиса.
`coolify_list_service_envs`	`uuid`	Перечислить переменные окружения сервиса.
`coolify_set_service_env`	`uuid`, `key`, `value`	Создать/обновить переменную окружения сервиса.
`coolify_bulk_set_service_envs`	`uuid`, `envs: [{key, value}]`	Массово обновить переменные окружения сервиса.
`coolify_delete_service_env`	`uuid`, `env_uuid`	Удалить переменную окружения сервиса.

📊 Ресурсы и промпты MCP

Ресурсы

coolify://overview — Агрегированная сводка в реальном времени по всем серверам, приложениям, базам данных и сервисам.
coolify://servers — Актуальный список серверов и статус доступности.
coolify://applications — Актуальный статус всех приложений и URL-адресов.
coolify://databases — Актуальный статус контейнеров баз данных.

Промпты

diagnose-application — Автоматизированный диагностический сценарий: проверяет состояние приложения, анализирует последние журналы и проверяет переменные окружения.
infrastructure-audit — Полная проверка работоспособности инфраструктуры: серверы, лимиты диска и упавшие контейнеры.
deployment-summary — Анализирует последние развертывания и выявляет ошибки сборки.

⚙️ Конфигурация и настройка клиента

Переменные окружения

Переменная	Описание	По умолчанию
`COOLIFY_BASE_URL`	Базовый URL вашего экземпляра Coolify (например, `https://coolify.example.com`)	`http://localhost:8000`
`COOLIFY_API_TOKEN`	Bearer-токен Coolify API	`""`
`COOLIFY_READ_ONLY`	Ограничить только действиями, не изменяющими состояние (`true`/`false`)	`false`

Примеры конфигурации клиента

1. Claude Desktop

Добавьте в 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` или `.cursor/mcp.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"
      }
    }
  }
}

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. Режим контейнера 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

🧪 Тестирование и проверка

Тестовый набор включает модульные тесты и полные сквозные интеграционные тесты, выполняемые на живом экземпляре Coolify v4 в Docker:

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

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

📄 Лицензия

Распространяется под MIT License. Подробности см. в LICENSE.

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
1 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)

🌟 Почему coolify-mcp?