Coolify MCP

🚀 Coolify MCP 服務器

Coolify MCP 服務器是一個用於管理 Coolify 部署的模型上下文協議（MCP）服務器，它既提供了編程式的 MCP 工具，也提供了全面的 CLI 命令。

🚀 快速開始

選項 1：MCP 集成（推薦）

MCP（模型控制協議）允許你直接從 AI 編輯器管理 Coolify。

1. 添加到你的 MCP 配置中

對於 Cursor： 添加到 ~/.cursor/mcp.json 或 <項目文件夾>/.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： 添加到 <項目文件夾>/.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 項操作）

70 多種一鍵服務，包括 WordPress、Ghost、MinIO 等，並提供完整的環境管理。

🗄️ 數據庫（13 項操作）

8 種數據庫類型：PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly。

📂 項目、服務器、部署

實現完整的基礎設施管理，包括私鑰、系統管理和部署監控。

💻 MCP 工具與 CLI 命令對比

此軟件包提供了兩種交互方式，且功能完全相同：

• 🤖 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（祝你好運公共許可證） - 詳情請參閱 LICENSE 文件。

此軟件可能正常工作，也可能無法正常工作，沒有第三種選擇。祝你好運，一路順風。

💻 使用示例

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