Skip to main content
Glama
frizikk

Coolify MCP Server

by frizikk

🚀 Coolify MCP Server (coolify-mcp)

TypeScript Node Version License: MIT Model Context Protocol Coolify API Tools

Coolify v4 セルフホスト型PaaS向けの、本番運用にも耐える包括的な Model Context Protocol (MCP) サーバーです。

AIコーディングアシスタントやエージェント(Claude DesktopCursorAntigravityClaude CodeWindsurfClineVS Code)をCoolifyインスタンスに直接接続し、自然言語でインフラのオーケストレーション、アプリケーションのデプロイ、8種類のデータベースの管理、環境変数の処理、ログの診断を行うことができます。


🌟 coolify-mcp を選ぶ理由

  • 🌐 Coolify v4 APIを100%完全カバー: プロジェクト、環境、サーバー、アプリケーション、データベース、Docker Composeサービス、デプロイ、チームメンバー、SSHキーを網羅する検証済みMCPツール77個。

  • 🔒 読み取り専用セーフティガード: --read-only(または COOLIFY_READ_ONLY=true)を有効にすると、AIアシスタントは変更や破壊を伴う操作を一切行わずに、監査・モニタリング・トラブルシューティングを行うことができます。

  • 🗄️ ユニバーサルデータベースエンジン対応: PostgreSQLMySQLMariaDBMongoDBRedisClickHouseDragonflyKeyDB を、エンジン固有のパラメータ正規化により、追加設定なしで作成・構成できます。

  • 📊 動的MCPリソース: トークンを消費しない周辺コンテキストのためのネイティブリソース(coolify://overviewcoolify://serverscoolify://applicationscoolify://databases)。

  • 💡 DevOpsプロンプトテンプレート: 自律的な診断とヘルスチェックのための、すぐに使えるプロンプトレシピ(diagnose-applicationinfrastructure-auditdeployment-summary)。

  • 🐳 Docker & Stdioトランスポート対応: 標準的なNode CLIツールとして、またはコンテナ間ネットワークをサポートする隔離されたDockerコンテナ内で実行できます。


🤖 AIエージェントセットアップ用プロンプト(コピー&ペースト)

AntigravityClaude CodeCursorWindsurfCline などの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_get_version

なし

実行中のCoolifyインスタンスのバージョン文字列を取得します。

coolify_get_health

なし

Coolifyバックエンドのヘルスチェックを実行します。

coolify_list_resources

なし

全プロジェクトにわたって管理されているすべてのリソースを一覧表示します。

coolify_get_infrastructure_overview

なし

集約したヘルス、サーバーステータス、アプリ、データベースのダッシュボードを取得します。

2. サーバー&ノード管理(8ツール)

Tool

Parameters

Description

coolify_list_servers

なし

到達可能性と使用可否フラグ付きで、登録済みの全サーバーを一覧表示します。

coolify_get_server

uuid

サーバーの詳細な設定、IP、設定値を取得します。

coolify_validate_server

uuid

サーバーへのSSH接続と接続性を検証します。

coolify_get_server_resources

uuid

特定のサーバーにデプロイされたすべてのリソースを一覧表示します。

coolify_get_server_domains

uuid

サーバー上のすべてのアクティブなドメインとルートを一覧表示します。

coolify_create_server

name, ip, port?, user?, private_key_uuid?, proxy_type?

新しいサーバーノードを登録します。

coolify_update_server

uuid, name?, description?, ip?, port?

サーバー設定を更新します。

coolify_delete_server

uuid

Coolifyからサーバーを削除します。

3. チーム&SSHキー(9ツール)

Tool

Parameters

Description

coolify_list_teams

なし

トークンでアクセス可能なすべてのチームを一覧表示します。

coolify_get_current_team

なし

認証済みのアクティブなチームの詳細を取得します。

coolify_get_current_team_members

なし

アクティブなチームのユーザーとロールを一覧表示します。

coolify_get_team

team_id

IDでチームの詳細を取得します。

coolify_get_team_members

team_id

IDで特定のチームのメンバーを一覧表示します。

coolify_list_private_keys

なし

登録済みのSSH秘密鍵をすべて一覧表示します。

coolify_get_private_key

uuid

秘密鍵の詳細を取得します。

coolify_create_private_key

name, private_key, description?

新しいSSH秘密鍵(Ed25519/RSA)を登録します。

coolify_delete_private_key

uuid

SSH秘密鍵を削除します。

4. プロジェクト&環境(9ツール)

Tool

Parameters

Description

coolify_list_projects

なし

すべてのプロジェクトと環境を一覧表示します。

coolify_get_project

uuid

プロジェクトの構造と環境一覧を取得します。

coolify_create_project

name, description?

新しいプロジェクトを作成します。

coolify_update_project

uuid, name?, description?

プロジェクト名または説明を更新します。

coolify_delete_project

uuid

空のプロジェクトを削除します。

coolify_list_environments

project_uuid

プロジェクト内の環境を一覧表示します。

coolify_get_environment

project_uuid, environment_name_or_uuid

環境の詳細を取得します。

coolify_create_environment

project_uuid, name

新しい環境(testingstaging)を作成します。

coolify_delete_environment

project_uuid, environment_name_or_uuid

環境を削除します。

5. アプリケーション(16ツール)

ツール

パラメータ

説明

coolify_list_applications

なし

すべてのスタンドアロンアプリケーションを一覧表示します。

coolify_get_application

uuid

アプリケーションの設定、ポート、ドメインを取得します。

coolify_create_application_public_git

project_uuid, server_uuid, environment_name, git_repository, git_branch, build_pack, name?

公開Gitリポジトリからデプロイします。

coolify_create_application_private_git

project_uuid, server_uuid, environment_name, git_repository, git_branch, private_key_uuid, build_pack, name?

非公開Gitリポジトリからデプロイします。

coolify_create_application_dockerfile

project_uuid, server_uuid, environment_name, dockerfile, name?

生のDockerfileまたはbase64のDockerfileからデプロイします。

coolify_create_application_docker_image

project_uuid, server_uuid, environment_name, docker_registry_image_name, docker_registry_image_tag?

ビルド済みDockerイメージをデプロイします。

coolify_update_application

uuid, name?, description?, domains?, build_pack?, ports_exposes?

アプリケーションの設定を更新します。

coolify_delete_application

uuid

アプリケーションとそのコンテナを削除します。

coolify_start_application

uuid

アプリケーションの起動/デプロイをトリガーします。

coolify_stop_application

uuid

実行中のアプリケーションコンテナを停止します。

coolify_restart_application

uuid

アプリケーションコンテナを再起動します。

coolify_get_application_logs

uuid

ランタイムコンテナのstdout/stderrログを取得します。

coolify_list_application_envs

uuid

アプリケーションのすべての環境変数を一覧表示します。

coolify_set_application_env

uuid, key, value, is_build_time?, is_literal?

環境変数を設定・作成します。

coolify_bulk_set_application_envs

uuid, envs: [{key, value}]

複数の環境変数を一括更新します。

coolify_delete_application_env

uuid, env_uuid

UUIDで環境変数を削除します。

6. デプロイメント(5ツール)

ツール

パラメータ

説明

coolify_list_deployments

なし

グローバルな実行中および完了済みのデプロイメントを一覧表示します。

coolify_list_app_deployments

app_uuid

特定のアプリのデプロイメント履歴を一覧表示します。

coolify_get_deployment

deployment_uuid

デプロイメントのステータス、コミット情報、ログを取得します。

coolify_cancel_deployment

deployment_uuid

進行中のデプロイメントをキャンセルします。

coolify_trigger_deployment

app_uuid, tag?

アプリの新しいデプロイメントをトリガーします。

7. データベース(14ツール)

ツール

パラメータ

説明

coolify_list_databases

なし

すべてのスタンドアロンデータベースを一覧表示します。

coolify_get_database

uuid

データベースの詳細と接続文字列を取得します。

coolify_create_database

type, project_uuid, server_uuid, environment_name, name?, image?, port?, is_public?

新しいデータベースを作成します。

coolify_update_database

uuid, name?, description?, is_public?, port?

データベース設定を更新します。

coolify_delete_database

uuid

データベースコンテナとボリュームを削除します。

coolify_start_database

uuid

データベースコンテナを起動します。

coolify_stop_database

uuid

データベースコンテナを停止します。

coolify_restart_database

uuid

データベースコンテナを再起動します。

coolify_get_database_backups

uuid

データベースのバックアップ設定を一覧表示します。

coolify_create_database_backup

uuid, frequency

データベースのバックアップを作成します。

coolify_update_database_backup

uuid, backup_uuid, frequency?, enabled?

バックアップ設定を更新します。

coolify_delete_database_backup

uuid, backup_uuid

バックアップ設定を削除します。

coolify_list_backup_executions

uuid, backup_uuid

バックアップ実行履歴を一覧表示します。

coolify_trigger_backup

uuid, backup_uuid

バックアップを即時トリガーします。

8. ワンクリックサービスとDocker Compose(12ツール)

ツール

パラメータ

説明

coolify_list_services

なし

ワンクリックサービスの一覧を表示します。

coolify_get_service

uuid

サービスのメタデータ、ドメイン、コンテナを取得します。

coolify_create_service

type, project_uuid, server_uuid, environment_name, name?, description?

ワンクリックテンプレート(Ghost、Plausible など)をデプロイします。

coolify_update_service

uuid, name?, description?

サービスの設定を更新します。

coolify_delete_service

uuid

サービススタックを削除します。

coolify_start_service

uuid

サービスコンテナを起動します。

coolify_stop_service

uuid

サービスコンテナを停止します。

coolify_restart_service

uuid

サービススタックを再起動します。

coolify_list_service_envs

uuid

サービスの環境変数を一覧表示します。

coolify_set_service_env

uuid, key, value

サービスの環境変数を作成・更新します。

coolify_bulk_set_service_envs

uuid, envs: [{key, value}]

サービスの環境変数を一括更新します。

coolify_delete_service_env

uuid, env_uuid

サービスの環境変数を削除します。


📊 MCP リソースとプロンプト

リソース

  • coolify://overview — 全サーバー、アプリ、データベース、サービスの集約されたリアルタイムサマリー。

  • coolify://servers — サーバーと到達可能性ステータスのライブリスト。

  • coolify://applications — 全アプリケーションとURLのライブステータス。

  • coolify://databases — データベースコンテナのライブステータス。

プロンプト

  • diagnose-application — 自動診断ワークフロー:アプリケーションの状態を確認し、最近のログを分析し、環境変数を検査します。

  • infrastructure-audit — サーバー、ディスク容量、失敗したコンテナにわたる完全なインフラストラクチャのヘルスチェック。

  • deployment-summary — 最近のデプロイを分析し、ビルド障害を明らかにします。


⚙️ 設定とクライアントセットアップ

環境変数

変数

説明

デフォルト

COOLIFY_BASE_URL

Coolify インスタンスのベース URL(例:https://coolify.example.com

http://localhost:8000

COOLIFY_API_TOKEN

Coolify API ベアラートークン

""

COOLIFY_READ_ONLY

非変更アクションに制限します(true/false

false


クライアント設定例

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 を参照してください。

-
license - not tested
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

View all MCP Connectors

Latest Blog Posts

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