de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Related Servers Score Discussions

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.

🤖 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 installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
daemoon
One PAT, any MCP agent: Vercel, GitHub, Cloudflare, Supabase, GCP — unified dev infra gateway.
Microsoft MCP Server for Enterprise
Official Microsoft MCP Server to query Microsoft Entra data using natural language

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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

🚀 Coolify MCP Server (coolify-mcp)

🌟 Warum coolify-mcp?