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

Ein umfassender, produktionsreifer Model Context Protocol (MCP)-Server für Coolify v4 selbst gehostetes PaaS.

Verbinden Sie KI-Coding-Assistenten und -Agenten (Claude Desktop, Cursor, Antigravity, Claude Code, Windsurf, Cline und VS Code) direkt mit Ihrer Coolify-Instanz, um Infrastruktur zu orchestrieren, Anwendungen bereitzustellen, 8 Arten von Datenbanken zu verwalten, Umgebungsvariablen zu handhaben und Logs in natürlicher Sprache zu diagnostizieren.

🌟 Warum `coolify-mcp`?

🌐 100% Vollständige Coolify-v4-API-Abdeckung: 77 verifizierte MCP-Tools für Projekte, Umgebungen, Server, Anwendungen, Datenbanken, Docker-Compose-Dienste, Bereitstellungen, Teammitglieder und SSH-Schlüssel.
🔒 Read-Only-Sicherheitswächter: Aktivieren Sie --read-only (oder COOLIFY_READ_ONLY=true), damit KI-Assistenten prüfen, überwachen und Fehler beheben können, ohne mutierende oder destruktive Aktionen auszuführen.
🗄️ Universelle Datenbank-Engine-Unterstützung: Out-of-the-box-Erstellung und -Konfiguration für PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly und KeyDB mit enginespezifischer Parameter-Normalisierung.
📊 Dynamische MCP-Ressourcen: Native Ressourcen (coolify://overview, coolify://servers, coolify://applications, coolify://databases) für Zero-Token-Kontext.
💡 DevOps-Prompt-Vorlagen: Vorgefertigte Prompt-Rezepte (diagnose-application, infrastructure-audit, deployment-summary) für autonome Diagnosen und Health-Checks.
🐳 Docker- und Stdio-Transport bereit: Läuft als standardmäßiges Node-CLI-Tool oder in isolierten Docker-Containern mit Container-zu-Container-Netzwerkunterstützung.

Related MCP server: Coolify MCP Server

🤖 KI-Agenten-Setup-Prompt (Kopieren & Einfügen)

Wenn Sie einen KI-Coding-Assistenten (wie Antigravity, Claude Code, Cursor, Windsurf oder Cline) verwenden, kopieren Sie einfach den folgenden Prompt und fügen Sie ihn in Ihren Assistenten ein:

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-Tools-Referenz

Der Server stellt 77 spezialisierte Tools bereit, die in 8 Kern-DevOps-Domänen organisiert sind:

1. System- & Infrastrukturübersicht (4 Tools)

Tool	Parameter	Beschreibung
`coolify_get_version`	keine	Laufende Coolify-Instanz-Versionszeichenfolge abrufen.
`coolify_get_health`	keine	Health-Check auf dem Coolify-Backend durchführen.
`coolify_list_resources`	keine	Alle Ressourcen auflisten, die über alle Projekte hinweg verwaltet werden.
`coolify_get_infrastructure_overview`	keine	Aggregiertes Dashboard für Health, Serverstatus, Apps und Datenbanken abrufen.

2. Server- & Knotenverwaltung (8 Tools)

Tool	Parameter	Beschreibung
`coolify_list_servers`	keine	Alle registrierten Server mit Erreichbarkeits- und Nutzbarkeits-Flags auflisten.
`coolify_get_server`	`uuid`	Detaillierte Serverkonfiguration, IP und Einstellungen abrufen.
`coolify_validate_server`	`uuid`	SSH-Verbindung und Konnektivität zu einem Server validieren.
`coolify_get_server_resources`	`uuid`	Alle Ressourcen auflisten, die auf einem bestimmten Server bereitgestellt werden.
`coolify_get_server_domains`	`uuid`	Alle aktiven Domains und Routen auf einem Server auflisten.
`coolify_create_server`	`name`, `ip`, `port?`, `user?`, `private_key_uuid?`, `proxy_type?`	Einen neuen Serverknoten registrieren.
`coolify_update_server`	`uuid`, `name?`, `description?`, `ip?`, `port?`	Serverkonfiguration aktualisieren.
`coolify_delete_server`	`uuid`	Einen Server aus Coolify entfernen.

3. Teams & SSH-Schlüssel (9 Tools)

Tool	Parameter	Beschreibung
`coolify_list_teams`	keine	Alle Teams auflisten, die für das Token zugänglich sind.
`coolify_get_current_team`	keine	Details des aktiven authentifizierten Teams abrufen.
`coolify_get_current_team_members`	keine	Benutzer und Rollen im aktiven Team auflisten.
`coolify_get_team`	`team_id`	Teamdetails nach ID abrufen.
`coolify_get_team_members`	`team_id`	Mitglieder eines bestimmten Teams nach ID auflisten.
`coolify_list_private_keys`	keine	Alle registrierten SSH-Private-Keys auflisten.
`coolify_get_private_key`	`uuid`	Private-Key-Details abrufen.
`coolify_create_private_key`	`name`, `private_key`, `description?`	Einen neuen SSH-Private-Key registrieren (Ed25519/RSA).
`coolify_delete_private_key`	`uuid`	Einen SSH-Private-Key löschen.

4. Projekte & Umgebungen (9 Tools)

Tool	Parameter	Beschreibung
`coolify_list_projects`	keine	Alle Projekte und Umgebungen auflisten.
`coolify_get_project`	`uuid`	Projektstruktur und Umgebungsliste abrufen.
`coolify_create_project`	`name`, `description?`	Ein neues Projekt erstellen.
`coolify_update_project`	`uuid`, `name?`, `description?`	Projektname oder -beschreibung aktualisieren.
`coolify_delete_project`	`uuid`	Ein leeres Projekt löschen.
`coolify_list_environments`	`project_uuid`	Umgebungen in einem Projekt auflisten.
`coolify_get_environment`	`project_uuid`, `environment_name_or_uuid`	Umgebungsdetails abrufen.
`coolify_create_environment`	`project_uuid`, `name`	Eine neue Umgebung erstellen (`testing`, `staging`).
`coolify_delete_environment`	`project_uuid`, `environment_name_or_uuid`	Eine Umgebung löschen.

5. Anwendungen (16 Tools)

Werkzeug	Parameter	Beschreibung
`coolify_list_applications`	keine	Alle Anwendungen auflisten.
`coolify_get_application`	`uuid`	Details einer bestimmten Anwendung abrufen.
`coolify_create_application`	`project_uuid`, `server_uuid`, `environment_name`, `type?`	Eine neue Anwendung erstellen (dockerfile, docker image, git).
`coolify_update_application`	`uuid`, `name?`, `description?`, `domains?`, `build_pack?`, `ports_exposes?`	Anwendungseinstellungen aktualisieren.
`coolify_delete_application`	`uuid`	Anwendung und ihre Container löschen.
`coolify_start_application`	`uuid`	Starten des Anwendungscontainers auslösen.
`coolify_stop_application`	`uuid`	Laufenden Anwendungscontainer stoppen.
`coolify_restart_application`	`uuid`	Anwendungscontainer neu starten.
`coolify_get_application_logs`	`uuid`	Laufzeitcontainer-Protokolle (stdout/stderr) abrufen.
`coolify_list_application_envs`	`uuid`	Alle Umgebungsvariablen der Anwendung auflisten.
`coolify_set_application_env`	`uuid`, `key`, `value`	Umgebungsvariable setzen oder erstellen.
`coolify_delete_application_env`	`uuid`, `key`	Eine Umgebungsvariable löschen.

6. Bereitstellungen (5 Werkzeuge)

Werkzeug	Parameter	Beschreibung
`coolify_list_deployments`	keine	Alle Bereitstellungen auflisten.
`coolify_get_deployment`	`uuid`	Details einer bestimmten Bereitstellung abrufen.
`coolify_create_deployment`	`uuid`	Eine neue Bereitstellung auslösen.
`coolify_cancel_deployment`	`uuid`	Eine laufende Bereitstellung abbrechen.
`coolify_list_deployment_logs`	`uuid`	Protokolle einer Bereitstellung abrufen.

7. Datenbanken (14 Werkzeuge)

Tool	Parameter	Beschreibung
`coolify_list_databases`	keine	Alle Datenbanken auflisten.
`coolify_get_database`	`uuid`	Details einer bestimmten Datenbank abrufen.
`coolify_create_database`	`project_uuid`, `server_uuid`, `environment_name`, `type?`	Eine neue Datenbank erstellen.
`coolify_update_database`	`uuid`, `description?`, `public_port?`	Datenbankeinstellungen aktualisieren.
`coolify_delete_database`	`uuid`	Datenbank und deren Daten löschen.
`coolify_start_database`	`uuid`	Datenbankcontainer starten.
`coolify_stop_database`	`uuid`	Datenbankcontainer stoppen.
`coolify_restart_database`	`uuid`	Datenbankcontainer neu starten.
`coolify_get_database_backups`	`uuid`	Backup-Konfigurationen für eine Datenbank auflisten.
`coolify_create_database_backup`	`uuid`, `frequency`, `enabled?`, `save_s3?`	Automatische Datenbank-Backups planen (cron).
`coolify_update_database_backup`	`uuid`, `backup_uuid`, `frequency?`, `enabled?`	Backup-Zeitplan aktualisieren.
`coolify_delete_database_backup`	`uuid`, `backup_uuid`	Backup-Konfiguration löschen.
`coolify_list_backup_executions`	`uuid`, `backup_uuid`	Verlauf der Backup-Ausführungen auflisten.
`coolify_delete_backup_execution`	`uuid`, `backup_uuid`, `execution_uuid`	Sicherungsausführung löschen.

8. One-Click-Dienste und Docker Compose (12 Werkzeuge)

Tool	Parameters	Description
`coolify_list_services`	none	Alle One-Click-Dienste auflisten.
`coolify_get_service`	`uuid`	Dienstmetadaten, Domains und Container abrufen.
`coolify_create_service`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `description?`	One-Click-Vorlage bereitstellen (Ghost, Plausible, usw.).
`coolify_update_service`	`uuid`, `name?`, `description?`	Diensteinstellungen aktualisieren.
`coolify_delete_service`	`uuid`	Dienst-Stack löschen.
`coolify_start_service`	`uuid`	Dienstcontainer starten.
`coolify_stop_service`	`uuid`	Dienstcontainer stoppen.
`coolify_restart_service`	`uuid`	Dienst-Stack neu starten.
`coolify_list_service_envs`	`uuid`	Umgebungsvariablen des Dienstes auflisten.
`coolify_set_service_env`	`uuid`, `key`, `value`	Umgebungsvariable des Dienstes erstellen/aktualisieren.
`coolify_bulk_set_service_envs`	`uuid`, `envs: [{key, value}]`	Umgebungsvariablen des Dienstes in großen Mengen aktualisieren.
`coolify_delete_service_env`	`uuid`, `env_uuid`	Eine Umgebungsvariable des Dienstes löschen.

📊 MCP-Ressourcen & Prompts

Ressourcen

coolify://overview — Aggregierte Echtzeit-Zusammenfassung aller Server, Apps, Datenbanken und Dienste.
coolify://servers — Live-Liste der Server und Erreichbarkeitsstatus.
coolify://applications — Live-Status aller Anwendungen und URLs.
coolify://databases — Live-Status der Datenbankcontainer.

Prompts

diagnose-application — Automatisierter Diagnose-Workflow: prüft den Anwendungsstatus, analysiert aktuelle Logs und untersucht Umgebungsvariablen.
infrastructure-audit — Vollständiger Infrastruktur-Gesundheitscheck über Server, Speicherlimits und fehlgeschlagene Container.
deployment-summary — Analysiert aktuelle Bereitstellungen und zeigt Build-Fehler auf.

⚙️ Konfiguration & Client-Setup

Umgebungsvariablen

Variable	Beschreibung	Standard
`COOLIFY_BASE_URL`	Basis-URL Ihrer Coolify-Instanz (z. B. `https://coolify.example.com`)	`http://localhost:8000`
`COOLIFY_API_TOKEN`	Coolify-API-Bearer-Token	`""`
`COOLIFY_READ_ONLY`	Auf nicht verändernde Aktionen beschränken (`true`/`false`)	`false`

Client-Konfigurationsbeispiele

1. Claude Desktop

Hinzufügen zu 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` oder Projekt `.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-Container-Modus

docker run -i --rm \
  -e COOLIFY_BASE_URL="http://coolify:8080" \
  -e COOLIFY_API_TOKEN="your-bearer-token" \
  --network coolify-network \
  coolify-mcp:latest

🧪 Tests & Verifizierung

Die Testsuite umfasst Unit-Tests und vollständige End-to-End-Integrationstests, die gegen eine live dockerisierte Coolify-v4-Instanz ausgeführt werden:

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

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

📄 Lizenz

Verteilt unter der MIT-Lizenz. Siehe LICENSE für Details.

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)

🌟 Warum coolify-mcp?