Coolify MCP 服务器

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

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，提供与 Coolify API 的集成。此服务器允许通过 MCP 工具与 Coolify 实例进行交互。

兼容性: 已通过 Coolify 版本 4.0.0-beta.397 测试

前提条件

• Node.js 18 或更高版本
• Coolify 基础 URL
• Coolify 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 （密钥 & 令牌 / API 令牌）
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 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_services: 列出所有服务
• create_service: 创建一个新服务
• start_service: 启动一个服务
• stop_service: 停止一个服务
• restart_service: 重启一个服务

应用

• list_applications: 列出所有应用
• create_application: 创建一个新应用
• start_application: 启动一个应用
• stop_application: 停止一个应用
• restart_application: 重启一个应用
• execute_command_application: 在应用容器中执行命令

部署

• list_deployments: 列出所有部署
• get_deployment: 获取部署详情

私钥

• list_private_keys: 列出所有私钥
• create_private_key: 创建一个新的私钥

许可证

MIT