Coolify MCP Server

<img src="graphics/CoolifyMCP.png" width="256" alt="Coolify MCP Logo" />

这是一个提供与Coolify API集成的Model Context Protocol服务器。此服务器通过MCP工具实现与Coolify实例的交互。

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

预备条件

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

功能

• 团队管理（列出、获取详情、成员）
• 项目管理（列出、获取、创建） ✨ 新功能
• 环境管理（列出、在项目中创建） ✨ 新功能
• 服务器管理（创建、验证、资源、域名）
• 服务生命周期管理（创建、启动、停止、重启）
• 应用程序生命周期管理（创建、启动、停止、重启、执行命令）
• 部署跟踪
• 私钥管理
• 版本和健康检查
• 增强错误报告，带有详细验证消息 ✨ 改进
• Coolify UUID格式兼容性 ✨ 修复

安装

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

# 或使用npx
npx coolify-mcp-server

配置

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

• COOLIFY_BASE_URL：你的Coolify实例的基础URL
• COOLIFY_TOKEN：你的Coolify API令牌

获取API令牌

1. 访问你的Coolify实例
2. 导航到 密钥与令牌 / API令牌
3. 创建一个具有以下所需权限的新令牌：
   • 读取（用于获取信息）
   • 写入（用于管理资源）
   • 部署（用于部署操作）

使用方法

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

可用工具

版本与健康

• 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：创建新私钥

许可证

MIT