Coolify MCP

🚀 Coolify MCP Server

Coolifyのデプロイを管理するためのModel Context Protocol (MCP)サーバーです。プログラムによるMCPツールと包括的なCLIコマンドの両方を提供します。

🚀 クイックスタート

オプション1: MCP統合 (推奨)

MCP (Model Control Protocol)を使用すると、AIエディタから直接Coolifyを管理できます。

1. MCP設定に追加

Cursorの場合: ~/.cursor/mcp.json または <project_folder>/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

VS Codeの場合: <project_folder>/.vscode/mcp.json に以下を追加します。

{
  "servers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      },
      "type": "stdio"
    }
  }
}

🔑 your-coolify-instance.com を実際のCoolifyのURLに、your-coolify-api-token をCoolifyの設定 > APIから取得したAPIトークンに置き換えてください。

2. (Cursorのみ) Coolify MCPを有効にする

Cursorの設定 (Ctrl+Shift+J) を開き ➡ MCPタブをクリック ➡ トグルでcoolify-mcpを有効にします。

3. Coolifyの管理を開始する

AIチャットで以下のようなコマンドを試してみてください。

List my Coolify applications
Create a new WordPress service called "my-blog" 
Deploy my app with ID "app-123"
Show me all available database types

オプション2: CLIの使用

インストール

# CLIで使用するためにグローバルにインストール
npm install -g @felixallistar/coolify-mcp

# インストールをテスト
coolify-mcp --help

設定

プロジェクトディレクトリに .env ファイルを作成します。

# 必須: あなたのCoolifyインスタンスのURL (必要に応じてポートを含む)
COOLIFY_API_URL=https://your-coolify-instance.com

# 必須: あなたのCoolify APIトークン (Coolify設定 > APIで生成)
COOLIFY_API_TOKEN=your-coolify-api-token

一般的なコマンド

# アプリケーション管理
coolify-mcp apps list
coolify-mcp apps create-public --name "my-app" --repository "https://github.com/user/repo" --project "project-id"
coolify-mcp apps start app-id

# サービス管理 (70以上のワンクリックサービス)
coolify-mcp services types
coolify-mcp services create --name "my-blog" --type "wordpress-with-mysql" --project "project-id"

# データベース管理 (8種類のデータベース)
coolify-mcp databases create-postgresql --name "main-db" --project "project-id"
coolify-mcp databases create-redis --name "cache" --project "project-id"

# プロジェクト管理
coolify-mcp projects list
coolify-mcp projects create --name "My Project"

# 接続性をテスト
coolify-mcp system health

✨ 主な機能

🔄 アプリケーション (21の操作)

6種類のデプロイタイプ、環境変数、ログ、および制御操作を備えた完全なアプリケーションライフサイクル管理。

🔧 サービス (14の操作)

WordPress、Ghost、MinIOなど70以上のワンクリックサービスと完全な環境管理。

🗄️ データベース (13の操作)

PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonflyの8種類のデータベース。

📂 プロジェクト、サーバー、デプロイ

秘密鍵、システム管理、およびデプロイモニタリングを含む完全なインフラストラクチャ管理。

MCPツールとCLIコマンドの比較

このパッケージは、機能的に完全に同等な2つの対話方法を提供します。

• 🤖 MCPツール: AIエージェントとCursorの統合に適しています (推奨)
• 💻 CLIコマンド: 直接ターミナルで使用する場合に適しています

どちらのインターフェースも同じ機能を提供しますので、あなたのワークフローに合わせて選択してください。

🔧 開発

APIの自動更新

Coolifyの最新のAPIと同期を保ちます。

npm run refresh           # 最新のAPI仕様をダウンロードして再構築
npm run check-updates     # APIの変更を確認

手動開発

git clone https://github.com/FelixAllistar/coolify-mcp.git
cd coolify-mcp
npm install
npm run refresh
npm run dev

📄 APIカバレッジ

✅ 100% Coolify APIカバレッジ - アプリケーション、サービス、データベース、プロジェクト、サーバー、デプロイ、秘密鍵、システム管理

📄 ライセンス

GLWTPL (Good Luck With That Public License) - 詳細は LICENSE ファイルを参照してください。

このソフトウェアは動くかもしれないし、動かないかもしれません。3つ目の選択肢はありません。幸運を祈ります。

MCP設定

オプション1: npxを使用する (推奨 - 簡単!)

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

オプション2: 直接nodeで実行する

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "node",
      "args": ["node_modules/@felixallistar/coolify-mcp/dist/index.js", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

オプション3: グローバルにインストールする

npm install -g @felixallistar/coolify-mcp

その後、MCPサーバーのバイナリを使用します。

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

💻 CLIの使用

CLIコマンドを使用するには、coolify-mcp コマンドに引数を追加するだけです。

# npxを使用する (インストール不要)
npx @felixallistar/coolify-mcp --help
npx @felixallistar/coolify-mcp apps list

# または、CLIでの使用を簡単にするためにグローバルにインストール
npm install -g @felixallistar/coolify-mcp
coolify-mcp --help
coolify-mcp apps list