MCP Server Coolify

冷却MCP服务器

用于Coolify API的综合模型上下文协议（MCP）服务器。该服务器使AI助手能够通过您的自托管Coolify PaaS平台管理基础设施、应用程序、数据库、服务等。

兼容性： 使用Coolify 4.0.0-beta.418版本进行测试

______________________________________________________________________

👋 开放机会！\ 我正在积极寻求新的机会和合作。如果你有有趣的项目或工作机会，请随时联系！\ 📧 联系人： pashvc@gmail.com

______________________________________________________________________

先决条件

• Node.js 18或更高版本
• 冷却基本URL
• Coolify API代币

特性

核心管理层

• 团队：列出团队，获取团队详细信息，查看团队成员
• 项目：创建、列出、更新和删除项目
• 服务器：创建服务器、验证连接、查看资源和域
• 私钥：管理服务器访问的SSH密钥

应用程序

• 完整的CRUD操作（创建、读取、更新、删除）
• 生命周期管理（启动、停止、重新启动）
• 在容器中执行命令
• 查看应用程序日志
• Git集成（存储库、分支、提交管理）
• 资源限制配置（内存、CPU）
• 健康检查配置

数据库

• 支持PostgreSQL、MySQL、MariaDB、MongoDB和Redis
• 创建和管理数据库实例
• 配置特定于数据库的设置
• 生命周期管理（启动、停止、重新启动）
• 资源限制和公共端口配置

服务

• 部署预配置的服务（合理、Umami、n8n等）
• 生命周期管理解决方案
• 配置更新

环境变量

• 管理应用程序、服务和数据库的环境变量
• 支持构建时和运行时变量
• 预览部署变量
• 跨环境共享变量

部署

• 列出所有部署
• 获取部署详细信息和日志
• 通过webhook触发部署
• 支持Docker镜像标签

开发者体验

• 常见工作流的预配置提示
• 全面的错误处理和详细的消息
• 完全类型安全的TypeScript支持
• 与MCP Inspector集成进行调试
• 适用于不同Coolify版本的强大API响应处理
• 单元和集成测试的广泛测试覆盖率

安装

# Install globally
npm install -g @pashvc/mcp-server-coolify

# Or use with npx
npx @pashvc/mcp-server-coolify

配置

服务器需要两个环境变量：

• COOLIFY_BASE_URL：Coolify实例的基本URL
• COOLIFY_TOKEN：您的Coolify API代币

获取API令牌

1. 转到您的Coolify实例
2. 引导到 Keys & Tokens / API tokens
3. 创建具有以下所需权限的新令牌：

- read（用于获取信息） - 写（用于管理资源） - 部署（用于部署操作）

用法

在MCP设置中

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

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@pashvc/mcp-server-coolify"],
      "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",
        "@pashvc/mcp-server-coolify"
      ],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

版本和运行状况

• coolify_version：获取Coolify版本信息
• coolify_health：检查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_projects：列出所有项目
• get_project：获取项目详细信息
• create_project：创建新项目
• update_project：更新项目设置
• delete_project：删除项目

应用程序

• list_applications：列出所有应用程序
• get_application：获取应用程序详细信息
• create_application：创建新应用程序
• update_application：更新应用程序设置
• delete_application：删除应用程序
• start_application：启动应用程序
• stop_application：停止应用程序
• restart_application：重新启动应用程序
• execute_command：在应用程序容器中执行命令
• get_application_logs：获取应用程序日志

数据库

• list_databases：列出所有数据库
• get_database：获取数据库详细信息
• create_database：创建新数据库
• update_database：更新数据库设置
• delete_database：删除数据库
• start_database：启动数据库
• stop_database：停止数据库
• restart_database：重新启动数据库

服务

• list_services：列出所有服务
• get_service：获取服务详细信息
• create_service：创建新服务
• update_service：更新服务设置
• delete_service：删除服务
• start_service：启动服务
• stop_service：停止服务
• restart_service：重新启动服务

环境变量

• list_environment_variables：列出环境变量
• create_environment_variable：创建新的环境变量
• update_environment_variable：更新环境变量
• delete_environment_variable：删除环境变量

部署

• list_deployments：列出所有部署
• get_deployment：获取部署详细信息
• deploy_webhook：通过webhook触发部署

私钥

• list_private_keys：列出所有私钥
• create_private_key：创建新的私钥
• update_private_key：更新私钥
• delete_private_key：删除私钥

预配置提示

服务器包括常见工作流的有用提示：

• deploy-git-app：从Git存储库部署新应用程序
• setup-database：设置具有正确配置的新数据库
• deploy-service：部署预配置的服务
• environment-setup：为应用程序设置环境变量
• server-health-check：对所有服务器进行全面的健康检查
• backup-database：创建数据库备份
• scale-application：通过调整资源来扩展应用程序
• setup-ssl：为应用程序配置SSL/TLS
• migrate-application：在服务器之间迁移应用程序
• troubleshoot-deployment：对失败的部署进行故障排除

发展

从源头构建

# Clone the repository
git clone https://github.com/pashvc/mcp-server-coolify.git
cd mcp-server-coolify

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

开发脚本

• npm run build：构建TypeScript项目
• npm run watch：构建并观察变化
• npm test：运行所有测试
• npm run test:watch：在监视模式下运行测试
• npm run test:coverage：使用覆盖率报告运行测试
• npm run test:integration：仅运行集成测试（需要env变量）
• npm run inspector：启动MCP检查器进行调试

故障排除

常见问题

• 404错误：某些端点可能并非在所有Coolify版本中都可用。服务器自动处理不同版本的不同响应格式。
• 身份验证错误：确保您的API令牌具有所需的权限（读取、写入、部署）。
• 连接问题：验证您的 COOLIFY_BASE_URL 是正确和可访问的。
• 环境变量：确保两者都 COOLIFY_BASE_URL 和 COOLIFY_TOKEN 设置正确。

测试您的设置

# Test with your credentials
export COOLIFY_BASE_URL="https://your-coolify-instance.com"
export COOLIFY_TOKEN="your-api-token"

# Run integration tests to verify connectivity
npm run test:integration

# Or test the server directly
npm run build && npm start

API兼容性

服务器自动处理不同的响应格式：

• 版本终结点：支持字符串和对象响应
• 列出端点：处理直接数组和分页响应
• 健康终点：适应不同的状态响应格式
• 错误处理：对各种错误消息格式的强大解析

许可证

麻省理工学院