Coolify MCP 服务器

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

兼容性: 测试版本为 Coolify 4.0.0-beta.397

前提条件

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

功能

• 团队管理（列表、获取详情、成员）
• 服务器管理（创建、验证、资源、域名）
• 服务生命周期管理（启动、停止、重启）
• 应用程序生命周期管理（启动、停止、重启、执行命令）
• 部署跟踪
• 私钥管理
• 版本和健康检查

安装

bash

全局安装

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. 创建一个新的令牌，需要以下权限：
   • 读取（用于获取信息）
   • 写入（用于管理资源）
   • 部署（用于部署操作）

使用

在 MCP 设置中

将以下内容添加到您的 MCP 设置配置中：

json
{
"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 命令行用户可能需要如下配置：

json
{
"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