Coolify MCP Server
2025.03.20
6
JavaScriptAPI 集成DevOps 工具开发效率
Coolify MCP Server 是一个基于 Model Context Protocol 的服务,用于与 Coolify API 进行集成。该服务允许通过 MCP 工具与 Coolify 实例进行交互,提供团队管理、服务器管理、服务生命周期管理、应用程序生命周期管理、部署跟踪、私钥管理等功能。
View on GitHub
Overview
基本能力
产品定位
Coolify MCP Server 是一个用于与 Coolify API 集成的服务,提供团队管理、服务器管理、服务生命周期管理等功能。
核心功能
- 团队管理:列出团队、获取团队详情、获取团队成员。
- 服务器管理:创建服务器、验证服务器配置、获取服务器资源和域名。
- 服务生命周期管理:启动、停止、重启服务。
- 应用程序生命周期管理:启动、停止、重启应用程序,执行容器命令。
- 部署跟踪:列出部署、获取部署详情。
- 私钥管理:列出私钥、创建私钥。
- 版本和健康检查:获取 Coolify 版本信息、检查 API 健康状态。
适用场景
- 需要与 Coolify 实例进行集成的开发团队。
- 需要自动化管理 Coolify 资源的 DevOps 团队。
- 需要监控和操作 Coolify 服务的运维人员。
工具列表
- 版本与健康:
get_version、health_check。 - 团队:
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。
常见问题解答
- 兼容性:测试与 Coolify 版本 4.0.0-beta.397 兼容。
- 环境变量:需要设置
COOLIFY_BASE_URL和COOLIFY_TOKEN。 - API 令牌:需要具有
read、write和deploy权限的 API 令牌。
使用教程
使用依赖
- Node.js 18 或更高版本。
- Coolify 基础 URL。
- Coolify API 令牌。
安装教程
# 全局安装
npm install -g coolify-mcp-server
# 或使用 npx
npx coolify-mcp-server
调试方式
- 确保环境变量
COOLIFY_BASE_URL和COOLIFY_TOKEN已正确设置。 - 使用
npx coolify-mcp-server启动服务。 - 使用提供的工具命令进行测试,例如
get_version或health_check。