Coolify MCP Server

Coolify MCP サーバー

Coolify v4.3.1 REST API を全面的にカバーする Model Context Protocol（MCP）サーバーです。MCP 対応の AI クライアントから、アプリケーション、データベース、サービス、サーバー、デプロイなどを管理できます。

互換性： Coolify v4.x。API のベース URL：https://<your-coolify-instance>/api/v1

Coolify v4.2.0 では状態を変更するエンドポイントが POST のみになりました。以前の GET ルートは、現在 This endpoint has changed to a POST request. を返します。このサーバーは、それらすべてに POST を使用します。ライフサイクル操作とデプロイ操作は、両方のメソッドを受け付けていた以前の v4.x リリースとも引き続き互換性があります。enable_api、disable_api、validate_server の 3 つのツールは、v4.2.0 より前は GET のみだったエンドポイントを呼び出すため、Coolify v4.2.0 以降が必要です。

前提条件

• Node.js 18 以降
• Coolify v4 インスタンスの実行（上記の 3 つのツールを使用する場合は v4.2.0 以降）
• Coolify API トークン（ダッシュボードの Security → API Tokens から取得）

インストール

# Install globally
npm install -g coolify-mcp-server

# Or use with npx (no install needed)
npx coolify-mcp-server

設定

次の 2 つの環境変数を設定します。

変数	説明
COOLIFY_BASE_URL	Coolify インスタンスのベース URL（例：https://coolify.example.com）
COOLIFY_TOKEN	Coolify API Bearer トークン

MCP 設定（Claude Desktop / Windsurf / Cline）

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Windows ユーザー（Cline/cmd）：

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

利用可能なツール

全般

• get_version — Coolify のバージョンを取得
• health_check — API のヘルスチェック（認証不要）
• enable_api / disable_api — API を有効化／無効化（root トークン）
• enable_mcp / disable_mcp — 組み込みの MCP エンドポイントを有効化／無効化（root トークン）

チーム

• list_teams、get_team、get_team_members
• get_current_team、get_current_team_members

サーバー

• list_servers、get_server、create_server、update_server、delete_server
• validate_server、get_server_resources、get_server_domains
• create_hetzner_server

プロジェクト

• list_projects、get_project、create_project、update_project、delete_project

環境

• list_environments、get_environment、create_environment、delete_environment

アプリケーション

• list_applications、get_application
• create_public_application、create_private_github_app_application、create_private_deploy_key_application
• create_dockerfile_application、create_dockerimage_application
• update_application、delete_application
• start_application、stop_application、restart_application
• get_application_logs
• list_application_envs、create_application_env、update_application_env、bulk_update_application_envs、delete_application_env
• list_application_storages、create_application_storage、delete_application_storage
• list_application_scheduled_tasks、create_application_scheduled_task、delete_application_scheduled_task

Docker Compose ファイルからリソースを直接作成するには、docker_compose_raw とともに create_service を使用してください。Coolify にはアプリケーションレベルの Compose 作成エンドポイントはありません。

データベース

• list_databases、get_database、update_database、delete_database
• create_postgresql_database、create_mysql_database、create_mariadb_database、create_mongodb_database
• create_redis_database、create_keydb_database、create_dragonfly_database、create_clickhouse_database
• start_database、stop_database、restart_database
• get_database_backups、create_database_backup、list_database_backup_executions
• list_database_envs、create_database_env、delete_database_env

サービス

• list_services, get_service, create_service, update_service, delete_service
• start_service, stop_service, restart_service
• list_service_envs, create_service_env, delete_service_env
• list_service_scheduled_tasks, create_service_scheduled_task, delete_service_scheduled_task

デプロイ

• list_deployments, get_deployment, cancel_deployment
• list_deployments_by_application, deploy_by_tag_or_uuid

秘密鍵

• list_private_keys, get_private_key, create_private_key, update_private_key, delete_private_key

GitHub Apps

• list_github_apps, create_github_app, delete_github_app, list_github_app_repositories

クラウドトークン

• list_cloud_tokens, create_cloud_token, delete_cloud_token

Hetzner

• get_hetzner_locations, get_hetzner_server_types, get_hetzner_images, get_hetzner_ssh_keys
• create_hetzner_server

リソース

• list_resources — インスタンス全体のすべてのリソース

ライセンス

MIT