Coolify MCP 服务器

一个提供与 Coolify API 集成的 Model Context Protocol (MCP) 服务器。此服务器支持通过 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
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": []
    }
  }
}

可用工具

版本与健康

• 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: 列出所有服务
• get_service: 获取特定服务的详细信息
• start_service: 启动服务
• stop_service: 停止服务
• restart_service: 重启服务

应用程序

• list_applications: 列出所有应用程序
• get_application: 获取特定应用程序的详细信息
• start_application: 启动应用程序
• stop_application: 停止应用程序
• restart_application: 重启应用程序
• execute_command: 执行命令

部署

• list_deployments: 列出所有部署
• get_deployment: 获取特定部署的详细信息
• deploy_application: 部署应用程序
• undeploy_application: 解除部署

许可证

MIT