Coolify MCP Server
🚀 Coolify MCP Server (coolify-mcp)
Комплексный 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. |
| нет | Выполнить проверку работоспособности бэкенда Coolify. |
| нет | Вывести список всех ресурсов, управляемых во всех проектах. |
| нет | Получить сводную панель с агрегированными данными о работоспособности, статусе серверов, приложений и баз данных. |
2. Управление серверами и узлами (8 инструментов)
Инструмент | Параметры | Описание |
| нет | Вывести список всех зарегистрированных серверов с флагами доступности и пригодности. |
|
| Получить подробную конфигурацию сервера, IP-адрес и настройки. |
|
| Проверить SSH-подключение и связь с сервером. |
|
| Вывести список всех ресурсов, развернутых на конкретном сервере. |
|
| Вывести список всех активных доменов и маршрутов на сервере. |
|
| Зарегистрировать новый серверный узел. |
|
| Обновить конфигурацию сервера. |
|
| Удалить сервер из Coolify. |
3. Команды и SSH-ключи (9 инструментов)
Инструмент | Параметры | Описание |
| нет | Вывести список всех команд, доступных по токену. |
| нет | Получить данные активной аутентифицированной команды. |
| нет | Вывести список пользователей и ролей в активной команде. |
|
| Получить данные команды по ID. |
|
| Вывести список участников конкретной команды по ID. |
| нет | Вывести список всех зарегистрированных SSH-приватных ключей. |
|
| Получить данные приватного ключа. |
|
| Зарегистрировать новый SSH-приватный ключ (Ed25519/RSA). |
|
| Удалить SSH-приватный ключ. |
4. Проекты и окружения (9 инструментов)
Инструмент | Параметры | Описание |
| нет | Вывести список всех проектов и окружений. |
|
| Получить структуру проекта и список окружений. |
|
| Создать новый проект. |
|
| Обновить название или описание проекта. |
|
| Удалить пустой проект. |
|
| Вывести список окружений в проекте. |
|
| Получить данные окружения. |
|
| Создать новое окружение ( |
|
| Удалить окружение. |
5. Приложения (16 инструментов)
Инструмент | Параметры | Описание |
| нет | Получить список всех автономных приложений. |
|
| Получить конфигурацию приложения, порты и домены. |
|
| Развернуть из публичного Git-репозитория. |
|
| Развернуть из приватного Git-репозитория. |
|
| Развернуть из Dockerfile в формате raw или base64. |
|
| Развернуть предварительно собранный Docker-образ. |
|
| Обновить конфигурацию приложения. |
|
| Удалить приложение и его контейнеры. |
|
| Инициировать запуск/развертывание приложения. |
|
| Остановить запущенный контейнер приложения. |
|
| Перезапустить контейнер приложения. |
|
| Получить журналы stdout/stderr контейнера во время выполнения. |
|
| Получить список всех переменных окружения приложения. |
|
| Установить/создать переменную окружения. |
|
| Массово обновить несколько переменных окружения. |
|
| Удалить переменную окружения по UUID. |
6. Развертывания (5 инструментов)
Инструмент | Параметры | Описание |
| нет | Получить список всех выполняющихся и завершенных развертываний. |
|
| Получить историю развертываний для конкретного приложения. |
|
| Получить статус развертывания, информацию о коммите и журналы. |
|
| Запустить немедленную сборку и развертывание. |
|
| Отменить выполняющееся развертывание. |
7. Базы данных (14 инструментов)
Инструмент | Параметры | Описание |
| нет | Получить список всех автономных баз данных. |
|
| Получить информацию о базе данных и строки подключения. |
|
| Создать базу данных (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB). |
|
| Обновить настройки базы данных. |
|
| Удалить контейнер и том базы данных. |
|
| Запустить контейнер базы данных. |
|
| Остановить контейнер базы данных. |
|
| Перезапустить контейнер базы данных. |
|
| Получить список конфигураций резервного копирования для базы данных. |
|
| Запланировать автоматическое резервное копирование базы данных (cron). |
|
| Обновить настройки расписания резервного копирования. |
|
| Удалить конфигурацию резервного копирования. |
|
| Получить историю выполнения резервного копирования. |
|
| Удалить конкретный артефакт выполнения резервного копирования. |
8. Сервисы в один клик и Docker Compose (12 инструментов)
Tool | Параметры | Описание |
| нет | Перечислить все сервисы в один клик. |
|
| Получить метаданные сервиса, домены и контейнеры. |
|
| Развернуть шаблон в один клик (Ghost, Plausible и т. д.). |
|
| Обновить настройки сервиса. |
|
| Удалить стек сервиса. |
|
| Запустить контейнеры сервиса. |
|
| Остановить контейнеры сервиса. |
|
| Перезапустить стек сервиса. |
|
| Перечислить переменные окружения сервиса. |
|
| Создать/обновить переменную окружения сервиса. |
|
| Массово обновить переменные окружения сервиса. |
|
| Удалить переменную окружения сервиса. |
📊 Ресурсы и промпты MCP
Ресурсы
coolify://overview— Агрегированная сводка в реальном времени по всем серверам, приложениям, базам данных и сервисам.coolify://servers— Актуальный список серверов и статус доступности.coolify://applications— Актуальный статус всех приложений и URL-адресов.coolify://databases— Актуальный статус контейнеров баз данных.
Промпты
diagnose-application— Автоматизированный диагностический сценарий: проверяет состояние приложения, анализирует последние журналы и проверяет переменные окружения.infrastructure-audit— Полная проверка работоспособности инфраструктуры: серверы, лимиты диска и упавшие контейнеры.deployment-summary— Анализирует последние развертывания и выявляет ошибки сборки.
⚙️ Конфигурация и настройка клиента
Переменные окружения
Переменная | Описание | По умолчанию |
| Базовый URL вашего экземпляра Coolify (например, |
|
| Bearer-токен Coolify API |
|
| Ограничить только действиями, не изменяющими состояние ( |
|
Примеры конфигурации клиента
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 installed
Maintenance
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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