Coolify MCP Server

🚀 Coolify MCP 服務器

Coolify MCP 服務器提供與 Coolify API 的集成，支持通過 Model Context Protocol (MCP) 工具與 Coolify 實例進行交互，為用戶提供便捷的管理體驗。

兼容性: 已測試與 Coolify 版本 4.0.0-beta.397 兼容

🚀 快速開始

先決條件

• Node.js 18 或更高版本
• Coolify 基礎 URL
• Coolify API 令牌

✨ 主要特性

• 團隊管理：支持列出團隊、獲取團隊詳細信息以及團隊成員信息。
• 服務器管理：可進行服務器的創建、驗證操作，還能獲取服務器資源和域名信息。
• 服務生命週期管理：能夠啟動、停止和重啟服務。
• 應用程序生命週期管理：支持啟動、停止、重啟應用程序，還可執行命令。
• 部署跟蹤：可對部署情況進行跟蹤。
• 私鑰管理：提供私鑰管理功能。
• 版本和健康檢查：可檢查版本信息和 API 健康狀態。

📦 安裝指南

# 全局安裝
npm install -g coolify-mcp-server

# 或使用 npx
npx coolify-mcp-server

📚 詳細文檔

配置

該服務器需要兩個環境變量：

• COOLIFY_BASE_URL：你的 Coolify 實例的基礎 URL
• COOLIFY_TOKEN：你的 Coolify API 令牌

獲取 API 令牌

1. 打開你的 Coolify 實例。
2. 轉到 Keys & Tokens / API tokens。
3. 創建一個具有以下權限的新令牌：
   • read（用於獲取信息）
   • write（用於管理資源）
   • deploy（用於部署操作）

使用方法

在 MCP 設置中

將以下內容添加到你的 MCP 設置配置中：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows 命令行用戶可能需要以下配置：

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

可用工具

📄 許可證

本項目採用 MIT 許可證。