Coolify MCP Server

Vue d'ensemble

Coolify MCP Server est le principal serveur Model Context Protocol (MCP) développé par la communauté pour Coolify, la populaire alternative open-source auto-hébergée de type PaaS à Heroku, Vercel et Netlify. Il permet aux assistants de codage IA (Claude Desktop, Cursor, Claude Code, etc.) de gérer entièrement et de déboguer votre instance Coolify en utilisant des commandes en langage naturel.

Avec 38 outils hautement optimisés, une recherche intelligente de ressources (par nom/domaine/IP au lieu des UUID), des réponses économes en tokens et une recherche de documentation en texte intégral intégrée, il transforme votre IA en un puissant co-pilote DevOps pour les déploiements auto-hébergés.

Fonctionnalités clés

• 38 Outils Optimisés : Couvre l'infrastructure, les serveurs, les projets, les applications, les bases de données, les services, les déploiements, les variables d'environnement, les clés privées, les équipes, les tokens cloud (Hetzner, DigitalOcean), et plus encore.
• Diagnostics Intelligents : diagnose_app, diagnose_server, find_issues avec des identifiants compréhensibles par l'homme.
• Opérations par Lot : Redémarrer des projets entiers, mises à jour groupées d'environnements, arrêt/redéploiement de plusieurs applications.
• Efficacité en Tokens : Les réponses sont 85 à 99% plus petites que l'API Coolify brute (par exemple, list_applications réduit de ~170Ko à ~4.4Ko).
• Recherche Docs en Texte Intégral : Recherche intégrée dans plus de 1500 morceaux de la documentation Coolify.
• Réponses Style HATEOAS : Inclut des suggestions d'actions suivantes et une pagination pour un meilleur contexte de l'IA.
• Prêt pour la Production : Couverture de tests > 98%, TypeScript strict, gestion robuste des erreurs.

Cas d'utilisation

• Déploiements Pilotés par IA : "Déploie mon application Next.js du dépôt GitHub X en production."
• Gestion d'Infrastructure : "Liste tous les serveurs, montre l'utilisation des ressources et redémarre le serveur de base de données."
• Débogage et Diagnostics : "Diagnostique pourquoi mon application échoue et suggère des corrections."
• Gestion par Lot : "Mets à jour les variables d'environnement dans toutes les applications du Projet Y et redéploie-les."
• Assistance Documentation : "Recherche dans la documentation Coolify comment configurer les sauvegardes PostgreSQL."
• Workflows DevOps Complets : Combinez avec d'autres serveurs MCP pour des pipelines de déploiement orchestrés par l'IA de bout en bout.

Installation (La plus simple)

Via npx (Recommandé pour Claude Desktop / Cursor / Claude Code)

# Pour Claude Desktop – ajoutez à claude_desktop_config.json
npx -y @masonator/coolify-mcp

Définissez ces variables d'environnement :

• COOLIFY_ACCESS_TOKEN (votre token API Coolify)
• COOLIFY_BASE_URL (par exemple https://your-coolify-instance.com)

Commande rapide pour Claude Code :

claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://your-coolify.com -- npx @masonator/coolify-mcp@latest

Le code source complet et les configurations Docker/manuelle sont disponibles dans le dépôt.

Compatibilité

• Clients : Claude Desktop, Cursor, Claude Code, tout outil IA compatible MCP.
• Version Coolify : Testé avec v4.0.0-beta.460+ (détection automatique des fonctionnalités).
• Licence : MIT

Communauté et Alternatives

Il s'agit de l'implémentation la plus activement maintenue et riche en fonctionnalités (v2.7.3 à compter de février 2026), publiée sur le registre officiel MCP. Les forks améliorés (par exemple, dazeb/coolify-mcp-enhanced) ajoutent des outils de déploiement supplémentaires si nécessaire.

Commencez dès aujourd'hui à gérer votre PaaS auto-hébergé avec l'IA — Coolify MCP Server rend le DevOps conversationnel et sans effort.