de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🚀 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 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コンテナ内で実行できます。

Related MCP server: Coolify MCP Server

🤖 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_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`	新しい環境（`testing`、`staging`）を作成します。
`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 を参照してください。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp
JustDeployOAuth
ai.justdeploy
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Cloud Platforms CI/CD & DevOps App Automation
2
https://mcp.justdeploy.ai/mcp
microservices.sh
sh.microservices
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Cloud Platforms Agent Orchestration Developer Tools
21
https://api.microservices.sh/mcp
serverOAuth
com.devopness.mcp
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
Cloud Platforms CI/CD & DevOps Developer Tools
3
https://mcp.devopness.com/mcp/

Related MCP Servers

Coolify MCP Server
Cloud Platforms Developer Tools Virtualization
kof70
A
license
B
quality
B
maintenance
Enables control and management of Coolify self-hosted PaaS instances, allowing you to deploy applications, manage databases, monitor servers, and execute operations directly from AI assistants.
Updated a month ago (2026-09-17 18:56 UTC)
89
9 npm
28
MIT
Coolify MCP Server
Cloud Platforms CI/CD & DevOps Developer Tools
JoshuaRileyDev
A
license
B
quality
D
maintenance
Enables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.
Updated a year ago (2025-06-15 17:53 UTC)
18
1 npm
3
MIT
coolify-mcp
Cloud Platforms Databases
jurislm
A
license
Not graded
quality
F
maintenance
MCP server for Coolify infrastructure management, providing 45 tools for servers, applications, databases, deployments, and diagnostics via natural language.
Updated 4 months ago (2026-07-11 05:18 UTC)
32 npm
MIT
coolify-mcp
Cloud Platforms Developer Tools CI/CD & DevOps
0xtlt
A
license
B
quality
A
maintenance
MCP server for managing Coolify instances, enabling control of applications, databases, services, servers, and more via natural language.
Updated 7 days ago (2026-10-22 05:30 UTC)
136
197 npm
MIT

🚀 Coolify MCP Server (coolify-mcp)

🌟 coolify-mcp を選ぶ理由