Coolify MCP Server

Coolify MCP 服务

一个 Model Context Protocol (MCP) 服务，全面覆盖 Coolify v4.3.1 REST API。通过任何兼容 MCP 的 AI 客户端管理应用、数据库、服务、服务器、部署等。

兼容性： Coolify v4.x。API 基础 URL：https://<your-coolify-instance>/api/v1

Coolify v4.2.0 将更改状态的端点改为仅支持 POST；原先的 GET 路由现在会 返回 This endpoint has changed to a POST request.。本服务会对这些路由全部使用 POST。 生命周期和部署操作仍兼容更早的 v4.x 版本，这些版本同时接受两种请求方法。三个工具——enable_api、disable_api 和 validate_server——调用的端点在 v4.2.0 之前仅支持 GET，因此 需要 Coolify v4.2.0 或更高版本。

先决条件

• Node.js 18 或更高版本
• 正在运行的 Coolify v4 实例（上述三个工具需要 v4.2.0+）
• Coolify API 令牌（在仪表板的 Security → API Tokens 中获取）

安装

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

# Or use with npx (no install needed)
npx coolify-mcp-server

配置

设置两个环境变量：

变量	描述
COOLIFY_BASE_URL	Coolify 实例的基础 URL（例如，https://coolify.example.com）
COOLIFY_TOKEN	Coolify API Bearer 令牌

MCP 设置（Claude Desktop / Windsurf / Cline）

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Windows 用户（Cline/cmd）：

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

可用工具

常规

• get_version — 获取 Coolify 版本
• health_check — API 健康检查（无需身份验证）
• enable_api / disable_api — 启用/禁用 API（root 令牌）
• enable_mcp / disable_mcp — 启用/禁用内置 MCP 端点（root 令牌）

团队

• list_teams、get_team、get_team_members
• get_current_team、get_current_team_members

服务器

• list_servers、get_server、create_server、update_server、delete_server
• validate_server、get_server_resources、get_server_domains
• create_hetzner_server

项目

• list_projects、get_project、create_project、update_project、delete_project

环境

• list_environments、get_environment、create_environment、delete_environment

应用

• list_applications、get_application
• create_public_application、create_private_github_app_application、create_private_deploy_key_application
• create_dockerfile_application、create_dockerimage_application
• update_application、delete_application
• start_application、stop_application、restart_application
• get_application_logs
• list_application_envs、create_application_env、update_application_env、bulk_update_application_envs、delete_application_env
• list_application_storages、create_application_storage、delete_application_storage
• list_application_scheduled_tasks、create_application_scheduled_task、delete_application_scheduled_task

要从原始 Docker Compose 文件创建资源，请使用 create_service 和 docker_compose_raw。Coolify 没有应用级的 Compose 创建端点。

数据库

• list_databases、get_database、update_database、delete_database
• create_postgresql_database、create_mysql_database、create_mariadb_database、create_mongodb_database
• create_redis_database、create_keydb_database、create_dragonfly_database、create_clickhouse_database
• start_database、stop_database、restart_database
• get_database_backups、create_database_backup、list_database_backup_executions
• list_database_envs、create_database_env、delete_database_env

服务

• list_services、get_service、create_service、update_service、delete_service
• start_service、stop_service、restart_service
• list_service_envs、create_service_env、delete_service_env
• list_service_scheduled_tasks、create_service_scheduled_task、delete_service_scheduled_task

部署

• list_deployments、get_deployment、cancel_deployment
• list_deployments_by_application、deploy_by_tag_or_uuid

私钥

• list_private_keys、get_private_key、create_private_key、update_private_key、delete_private_key

GitHub 应用

• list_github_apps、create_github_app、delete_github_app、list_github_app_repositories

云令牌

• list_cloud_tokens、create_cloud_token、delete_cloud_token

Hetzner

• get_hetzner_locations、get_hetzner_server_types、get_hetzner_images、get_hetzner_ssh_keys
• create_hetzner_server

资源

• list_resources — 实例中的所有资源

许可证

MIT