StuMason/coolify-mcp

何を解決するか

このプロジェクトは、Claude、Cursor、または他のMCP互換ツールなどのAIクライアントを通じて、自然言語で自己ホスト型Coolify PaaS（Platform-as-a-Service）を管理できるModel Context Protocol (MCP) サーバーを提供します。これにより、一般的なデプロイ、デバッグ、運用タスクのためにCoolifyダッシュボードを手動で操作する必要がなくなります。

動作方法

サーバーはAIアシスタントとCoolify v4 APIの間のブリッジとして機能します。AIが呼び出すことができる44の統合ツールを公開しており、アプリケーションのデプロイ、データベースの管理、環境変数の更新、システムの健全性チェックなどの操作が可能です。LLMのコンテキストウィンドウを最適化するために、サーバーは統合されたアクション・パラメータツールを使用し、生のAPI応答ではなく、リソースの要約投影を返します。

対象ユーザー

自らのアプリケーションをホストするためにCoolifyを使用し、インフラストラクチャ管理をAI駆動の開発およびチャット環境に統合したいDevOpsエンジニア、開発者、システム管理者。

主な特徴

• 包括的なツールセット：インフラストラクチャ概要、診断、バッチ操作、サーバー/プロジェクト/環境/アプリケーションログ、データベース管理、クラウドプロバイダー統合（Hetzner/DigitalOcean）のためのツールを含む。
• トークン最適化：ツール定義を約6,600トークン（元は約43,000）に削減し、コンテキストウィンドウのスペースを節約。
• セーフティガードレール：リソース削除やすべてのアプリの停止など破壊的な操作に対して、人間による確認（エリシテーション）を実装。デフォルトでAPI境界でシークレットをマスク。
• 検証済みデプロイ：deployツールは終了状態をポーリングし、失敗時にログの末尾を返すため、単なるHTTP応答よりも信頼性の高い成功確認が可能。
• ドキュメント検索：Coolifyのドキュメント全体に対して全文検索を統合し、AIアシスタントがより良いトラブルシューティングアドバイスを提供できるようにします。