Coolify MCP Server
🚀 Coolify MCP Server (coolify-mcp)
Coolify v4 セルフホスト型PaaS向けの、本番運用にも耐える包括的な Model Context Protocol (MCP) サーバーです。
AIコーディングアシスタントやエージェント(Claude Desktop、Cursor、Antigravity、Claude Code、Windsurf、Cline、VS Code)をCoolifyインスタンスに直接接続し、自然言語でインフラのオーケストレーション、アプリケーションのデプロイ、8種類のデータベースの管理、環境変数の処理、ログの診断を行うことができます。
🌟 coolify-mcp を選ぶ理由
🌐 Coolify v4 APIを100%完全カバー: プロジェクト、環境、サーバー、アプリケーション、データベース、Docker Composeサービス、デプロイ、チームメンバー、SSHキーを網羅する検証済みMCPツール77個。
🔒 読み取り専用セーフティガード:
--read-only(またはCOOLIFY_READ_ONLY=true)を有効にすると、AIアシスタントは変更や破壊を伴う操作を一切行わずに、監査・モニタリング・トラブルシューティングを行うことができます。🗄️ ユニバーサルデータベースエンジン対応: PostgreSQL、MySQL、MariaDB、MongoDB、Redis、ClickHouse、Dragonfly、KeyDB を、エンジン固有のパラメータ正規化により、追加設定なしで作成・構成できます。
📊 動的MCPリソース: トークンを消費しない周辺コンテキストのためのネイティブリソース(
coolify://overview、coolify://servers、coolify://applications、coolify://databases)。💡 DevOpsプロンプトテンプレート: 自律的な診断とヘルスチェックのための、すぐに使えるプロンプトレシピ(
diagnose-application、infrastructure-audit、deployment-summary)。🐳 Docker & Stdioトランスポート対応: 標準的なNode CLIツールとして、またはコンテナ間ネットワークをサポートする隔離されたDockerコンテナ内で実行できます。
🤖 AIエージェントセットアップ用プロンプト(コピー&ペースト)
Antigravity、Claude Code、Cursor、Windsurf、Cline などのAIコーディングアシスタントを使用している場合は、以下のプロンプトをコピーしてアシスタントに貼り付けるだけです:
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ツールリファレンス
このサーバーは、8つの主要なDevOps領域に分類された 77個の専門ツール を提供します:
1. システム&インフラストラクチャ概要(4ツール)
Tool | Parameters | Description |
| なし | 実行中のCoolifyインスタンスのバージョン文字列を取得します。 |
| なし | Coolifyバックエンドのヘルスチェックを実行します。 |
| なし | 全プロジェクトにわたって管理されているすべてのリソースを一覧表示します。 |
| なし | 集約したヘルス、サーバーステータス、アプリ、データベースのダッシュボードを取得します。 |
2. サーバー&ノード管理(8ツール)
Tool | Parameters | Description |
| なし | 到達可能性と使用可否フラグ付きで、登録済みの全サーバーを一覧表示します。 |
|
| サーバーの詳細な設定、IP、設定値を取得します。 |
|
| サーバーへのSSH接続と接続性を検証します。 |
|
| 特定のサーバーにデプロイされたすべてのリソースを一覧表示します。 |
|
| サーバー上のすべてのアクティブなドメインとルートを一覧表示します。 |
|
| 新しいサーバーノードを登録します。 |
|
| サーバー設定を更新します。 |
|
| Coolifyからサーバーを削除します。 |
3. チーム&SSHキー(9ツール)
Tool | Parameters | Description |
| なし | トークンでアクセス可能なすべてのチームを一覧表示します。 |
| なし | 認証済みのアクティブなチームの詳細を取得します。 |
| なし | アクティブなチームのユーザーとロールを一覧表示します。 |
|
| IDでチームの詳細を取得します。 |
|
| IDで特定のチームのメンバーを一覧表示します。 |
| なし | 登録済みのSSH秘密鍵をすべて一覧表示します。 |
|
| 秘密鍵の詳細を取得します。 |
|
| 新しいSSH秘密鍵(Ed25519/RSA)を登録します。 |
|
| SSH秘密鍵を削除します。 |
4. プロジェクト&環境(9ツール)
Tool | Parameters | Description |
| なし | すべてのプロジェクトと環境を一覧表示します。 |
|
| プロジェクトの構造と環境一覧を取得します。 |
|
| 新しいプロジェクトを作成します。 |
|
| プロジェクト名または説明を更新します。 |
|
| 空のプロジェクトを削除します。 |
|
| プロジェクト内の環境を一覧表示します。 |
|
| 環境の詳細を取得します。 |
|
| 新しい環境( |
|
| 環境を削除します。 |
5. アプリケーション(16ツール)
ツール | パラメータ | 説明 |
| なし | すべてのスタンドアロンアプリケーションを一覧表示します。 |
|
| アプリケーションの設定、ポート、ドメインを取得します。 |
|
| 公開Gitリポジトリからデプロイします。 |
|
| 非公開Gitリポジトリからデプロイします。 |
|
| 生のDockerfileまたはbase64のDockerfileからデプロイします。 |
|
| ビルド済みDockerイメージをデプロイします。 |
|
| アプリケーションの設定を更新します。 |
|
| アプリケーションとそのコンテナを削除します。 |
|
| アプリケーションの起動/デプロイをトリガーします。 |
|
| 実行中のアプリケーションコンテナを停止します。 |
|
| アプリケーションコンテナを再起動します。 |
|
| ランタイムコンテナのstdout/stderrログを取得します。 |
|
| アプリケーションのすべての環境変数を一覧表示します。 |
|
| 環境変数を設定・作成します。 |
|
| 複数の環境変数を一括更新します。 |
|
| UUIDで環境変数を削除します。 |
6. デプロイメント(5ツール)
ツール | パラメータ | 説明 |
| なし | グローバルな実行中および完了済みのデプロイメントを一覧表示します。 |
|
| 特定のアプリのデプロイメント履歴を一覧表示します。 |
|
| デプロイメントのステータス、コミット情報、ログを取得します。 |
|
| 進行中のデプロイメントをキャンセルします。 |
|
| アプリの新しいデプロイメントをトリガーします。 |
7. データベース(14ツール)
ツール | パラメータ | 説明 |
| なし | すべてのスタンドアロンデータベースを一覧表示します。 |
|
| データベースの詳細と接続文字列を取得します。 |
|
| 新しいデータベースを作成します。 |
|
| データベース設定を更新します。 |
|
| データベースコンテナとボリュームを削除します。 |
|
| データベースコンテナを起動します。 |
|
| データベースコンテナを停止します。 |
|
| データベースコンテナを再起動します。 |
|
| データベースのバックアップ設定を一覧表示します。 |
|
| データベースのバックアップを作成します。 |
|
| バックアップ設定を更新します。 |
|
| バックアップ設定を削除します。 |
|
| バックアップ実行履歴を一覧表示します。 |
|
| バックアップを即時トリガーします。 |
8. ワンクリックサービスとDocker Compose(12ツール)
ツール | パラメータ | 説明 |
| なし | ワンクリックサービスの一覧を表示します。 |
|
| サービスのメタデータ、ドメイン、コンテナを取得します。 |
|
| ワンクリックテンプレート(Ghost、Plausible など)をデプロイします。 |
|
| サービスの設定を更新します。 |
|
| サービススタックを削除します。 |
|
| サービスコンテナを起動します。 |
|
| サービスコンテナを停止します。 |
|
| サービススタックを再起動します。 |
|
| サービスの環境変数を一覧表示します。 |
|
| サービスの環境変数を作成・更新します。 |
|
| サービスの環境変数を一括更新します。 |
|
| サービスの環境変数を削除します。 |
📊 MCP リソースとプロンプト
リソース
coolify://overview— 全サーバー、アプリ、データベース、サービスの集約されたリアルタイムサマリー。coolify://servers— サーバーと到達可能性ステータスのライブリスト。coolify://applications— 全アプリケーションとURLのライブステータス。coolify://databases— データベースコンテナのライブステータス。
プロンプト
diagnose-application— 自動診断ワークフロー:アプリケーションの状態を確認し、最近のログを分析し、環境変数を検査します。infrastructure-audit— サーバー、ディスク容量、失敗したコンテナにわたる完全なインフラストラクチャのヘルスチェック。deployment-summary— 最近のデプロイを分析し、ビルド障害を明らかにします。
⚙️ 設定とクライアントセットアップ
環境変数
変数 | 説明 | デフォルト |
| Coolify インスタンスのベース URL(例: |
|
| Coolify API ベアラートークン |
|
| 非変更アクションに制限します( |
|
クライアント設定例
1. Claude Desktop
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 または プロジェクトの .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 コンテナモード
docker run -i --rm \
-e COOLIFY_BASE_URL="http://coolify:8080" \
-e COOLIFY_API_TOKEN="your-bearer-token" \
--network coolify-network \
coolify-mcp:latest🧪 テストと検証
テストスイートには、Docker 化された Coolify v4 のライブインスタンスに対して実行される単体テストと完全なエンドツーエンド統合テストが含まれています:
# Run all automated unit and integration tests (43 tests)
pnpm test
# Run complete 77-tool live verification suite
pnpm test:verify-live📄 ライセンス
MIT ライセンスの下で配布されています。詳細は LICENSE を参照してください。
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
One PAT, any MCP agent: Vercel, GitHub, Cloudflare, Supabase, GCP — unified dev infra gateway.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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