Coolify MCP Server (Wrediam)

冷却MCP服务器

提供与Coolify API集成的模型上下文协议服务器。此服务器允许通过MCP工具与Coolify实例进行交互。

兼容性： 支持Coolify 4.0.0-beta.380+版本，具有自动版本检测和功能兼容性。经过4.0.0-beta.420.1之前版本的测试。更新API端点以匹配官方Coolify文档。

先决条件

• Node.js 18或更高版本
• 冷却基本URL
• Coolify API代币

特性

• 团队管理（列表、获取详细信息、成员）
• 项目管理（列表、获取、创建） ✨ 新
• 环境管理（列出、在项目内创建） ✨ 新
• 服务器管理（创建、验证、资源、域）
• 服务生命周期管理（创建、启动、停止、重新启动）
• 应用程序生命周期管理（创建、启动、停止、重新启动、执行命令）
• 部署跟踪
• 私钥管理
• 版本和健康检查
• 通过详细的验证消息增强错误报告 ✨ 改进
• 冷却UUID格式兼容性 ✨ 固定的

安装

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

# Or use with npx
npx coolify-mcp-server

配置

服务器需要两个环境变量：

• COOLIFY_BASE_URL：Coolify实例的基本URL
• COOLIFY_TOKEN：您的Coolify API代币

获取API令牌

1. 转到您的Coolify实例
2. 引导到 Keys & Tokens / API tokens
3. 创建具有以下所需权限的新令牌：

- read（用于获取信息） - 写（用于管理资源） - 部署（用于部署操作）

用法

在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 Cline用户可能需要以下内容：

{
  "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": []
    }
  }
}

可用工具

版本和运行状况

• get_version：获取Coolify版本信息
• health_check：检查Coolify API运行状况

团队

• list_teams：列出所有团队
• get_team：获取特定团队的详细信息
• get_current_team：获取当前团队详细信息
• get_current_team_members：获取当前团队成员

服务器

• list_servers：列出所有服务器
• create_server：创建新服务器
• validate_server：验证服务器配置
• get_server_resources：获取服务器资源使用情况
• get_server_domains：获取服务器域

项目✨ 新

• list_projects：列出所有项目
• get_project：获取特定项目的详细信息
• create_project：创建新项目

环境✨ 新

• list_environments：列出项目中的环境
• create_environment：在项目中创建新环境

服务

• list_services：列出所有服务
• create_service：创建新服务
• start_service：启动服务
• stop_service：停止服务
• restart_service：重新启动服务

应用程序

• list_applications：列出所有应用程序
• create_application：创建新应用程序
• start_application：启动应用程序
• stop_application：停止应用程序
• restart_application：重新启动应用程序
• execute_command_application：在应用程序容器中执行命令
• get_application_logs：获取用于调试的应用程序日志

部署

• list_deployments：列出所有部署
• get_deployment：获取部署详细信息

私钥

• list_private_keys：列出所有私钥
• create_private_key：创建新的私钥

许可证

麻省理工学院