Coolify MCP

Coolify MCP

frndchagasMIT
3 звёзд3 форков
MCP-сервер для интеграции AI-ассистентов с платформой Coolify. Сервер подключается к вашему инстансу через REST API и транслирует команды ассистента в 38 конкретных операций: от создания проектов и серверов до деплоя контейнеров и управления секретами. Сервер рассчитан на разработчиков и DevOps-инженеров, которые хотят автоматизировать развертывание. Вместо того чтобы заходить в веб-интерфейс Coolify, вы описываете задачу ассистенту, а он выполняет её через MCP. Это ускоряет рутинные операции и снижает риск ошибок.
DevelopmentCoolify
Открыть на GitHubОфициальный сайт

Установка

npx -y @fndchagas/coolify-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикfrndchagas
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Создаёт проекты и окружения (production, staging) с нуля
  • Деплоит приложения из публичных и приватных Git-репозиториев
  • Поддерживает 6 типов приложений: публичный Git, GitHub App, Deploy Key, Dockerfile, Docker Image, Docker Compose
  • Управляет переменными окружения: создаёт, читает, обновляет и удаляет их
  • Маскирует секреты в переменных окружения и скрывает их при выводе логов
  • Запускает, останавливает и перезагружает сервисы
  • Включает защиту от записи, чтобы блокировать случайные изменения в боевых средах
  • Автоматически очищает логи от конфиденциальных данных для предотвращения утечек
  • Предоставляет 38 инструментов для полного покрытия Coolify API

Как подключить

Установка

Выполните в терминале:

npm install -g @fndchagas/coolify-mcp

Если не хотите устанавливать глобально, используйте временный запуск:

npx -y @fndchagas/coolify-mcp

Настройка клиента

Отредактируйте конфигурационный файл вашего MCP-клиента. Для Claude Desktop это claude_desktop_config.json.

{ "mcpServers": { "coolify": { "command": "npx", "args": ["-y", "@fndchagas/coolify-mcp"], "env": { "COOLIFY_BASE_URL": "https://ваш.coolify.app/api/v1", "COOLIFY_TOKEN": "ваш_токен_api", "COOLIFY_ALLOW_WRITE": "true" } } } }

Переменная COOLIFY_BASE_URL указывает на адрес вашего инстанса Coolify. COOLIFY_TOKEN — API-токен из раздела Settings → API. COOLIFY_ALLOW_WRITE со значением true разрешает ассистенту вносить изменения.

Перезапуск

Сохраните файл и перезапустите клиент. Теперь ассистент может управлять Coolify через MCP-сервер. Для проверки попросите ассистента показать список проектов.

Примеры запросов

  • «Создай проект backend в Coolify. Добавь сервер на Ubuntu и настрой подключение по SSH»
  • «Задеплой приложение из репозитория github.com/user/app, ветка main. Тип — публичный репозиторий»
  • «Покажи все переменные окружения для production-окружения приложения api. Спрячь секреты»
  • «Останови сервис frontend, выведи последние 20 строк лога»
  • «Пересобери приложение из Docker Compose в папке docker/ и запусти его»

Технические детали

  • Язык разработки: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Минимальная версия Node.js: 18
  • Совместимые клиенты: Claude Desktop, OpenAI Codex CLI и другие MCP-клиенты

Поделиться