StuMason/coolify-mcp

何を解決するか

AIクライアント（Claude、Cursor、またはMCP互換ツール）を通じて、自然言語で自身のCoolify自己ホスト型PaaS（Platform-as-a-Service）を管理できるようにします。複雑なインフラ管理インターフェースとAIエージェントの間のギャップを埋め、手動のAPI呼び出しやダッシュボードのナビゲーションなしに、サーバーやアプリケーションのデプロイ、デバッグ、運用が可能になります。

動作方法

このプロジェクトは、46の専門的なツールをAIモデルに公開するModel Context Protocol (MCP) サーバーを実装しています。これらのツールはCoolify APIと連携し、アプリのデプロイ、ログの読み取り、環境変数の管理などの操作を実行します。3つのデプロイモードをサポートしています：Claude Desktop向けのワンクリックインストール、npxによるローカルインストール、HTTP/OAuth 2.1を使用したリモートコンテナ化モード。また、設定と接続性を検証するためのdoctorコマンドも含まれています。

対象ユーザー

• DevOpsエンジニアおよび開発者：チャットを通じてインフラを管理したい人。
• 代理店：複数のクライアント向けに複数のCoolifyインスタンスを管理する場合（「フリートモード」で）。
• 自己ホスト型PaaSの利用者：手動のCLIやGUIではなく、エージェントワークフローでトラブルシューティングやデプロイを好む人。

特徴

• 包括的なツールセット：アプリの診断、デプロイ/ロールバック、リソースの作成、設定の処理に使える46のツール。
• 安全最優先：破壊的操作は対応するクライアントで人間の確認が必要であり、シークレットはAPI境界でマスクされます。
• マルチインスタンス対応：1つの接続から複数のCoolifyインスタンス（「フリート」）を管理可能。
• 組み込みワークフロー：アプリのトラブルシューティング、失敗したデプロイの説明、エスタートの健全性チェックのための事前定義されたプロンプトを含む。
• 接続診断機能：一般的な設定エラーを特定し、1行で修正できるdoctorツールを搭載。