Skip to main content
Glama
frizikk

Coolify MCP Server

by frizikk

🚀 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-контейнеров с поддержкой сетевого взаимодействия между контейнерами.


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

Если вы используете ИИ-ассистента для разработки (например, 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.

-
license - not tested
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • One PAT, any MCP agent: Vercel, GitHub, Cloudflare, Supabase, GCP — unified dev infra gateway.

  • Official Microsoft MCP Server to query Microsoft Entra data using natural language

View all MCP Connectors

Latest Blog Posts

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