Coolify MCP Server

Краткое назначение

coolify-mcp-server — MCP-сервер, который оборачивает Coolify v4 HTTP API в 72 типизированных инструмента для AI-агентов.

Бизнес-задача

DevOps-панель Coolify управляет приложениями, сервисами, базами данных, переменными окружения, серверами и деплоями. Проект позволяет AI-агентам выполнять эти операции через безопасный и структурированный интерфейс.

Техническое решение

Сервер публикует MCP tools для чтения, создания, обновления, удаления и деплоя ресурсов Coolify. Поддержана multi-host конфигурация: один MCP-сервер может работать с несколькими Coolify-инстансами через server_id.

Архитектура

• stdio MCP transport;
• конфигурация профилей Coolify через .env;
• typed tools для проектов, приложений, сервисов, баз данных, серверов и SSH-ключей;
• safety gates: confirm: true для create/update/delete/execute операций;
• token redaction в логах;
• mock Coolify + stdio driver для end-to-end тестов.

Стек

Node.js, TypeScript, MCP, Coolify API, Zod, stdio JSON-RPC, dotenv, end-to-end testing.

Интеграции

• Coolify v4 API;
• Docker/Coolify deployment workflows;
• MCP-compatible AI clients.

Ограничения и риски

Инструменты управления инфраструктурой должны иметь защиту от случайных мутаций. Поэтому проект разделяет read operations и write operations, а опасные действия требуют явного подтверждения.

Что показывает в портфолио

DevOps automation, AI tooling, безопасность операций, multi-host архитектуру и production-grade подход к JSON-RPC/stdio серверам.

Ссылка

https://github.com/NohchiyBors/coolify-mcp-server