STARWARCLOUD STARWAR.AI
返回市场
MCP服务器冷却器

MCP服务器冷却器

作者：pavelsukhachev3 星标更新：2025-05-28
安装使用来源：spider==github.com

项目介绍

Coolify MCP 服务器

<img src="graphics/CoolifyMCP.png" width="256" alt="Coolify MCP 标志" />

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

兼容性： 已测试与 Coolify 版本 4.0.0-beta.418 兼容

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

前提条件

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

功能

核心管理

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

应用程序

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

数据库

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

服务

  • 部署预配置的服务（Plausible、Umami、n8n 等）
  • 服务生命周期管理
  • 配置更新

环境变量

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

部署

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

开发者体验

  • 预配置常见工作流提示
  • 具有详细消息的综合错误处理
  • TypeScript 支持，具有完整的类型安全性
  • 与 MCP Inspector 集成进行调试
  • 处理不同 Coolify 版本的 API 响应
  • 单元测试和集成测试的广泛覆盖

安装

# 全局安装
npm install -g @pashvc/mcp-server-coolify

# 或使用 npx
npx @pashvc/mcp-server-coolify

配置

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

  • COOLIFY_BASE_URL：您的 Coolify 实例的基础 URL
  • COOLIFY_TOKEN：您的 Coolify API 令牌

获取 API 令牌

  1. 访问您的 Coolify 实例
  2. 导航到 密钥与令牌 / API 令牌
  3. 创建一个具有以下所需权限的新令牌：
    • 读取（用于获取信息）
    • 写入（用于管理资源）
    • 部署（用于部署操作）

使用方法

在 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 命令行用户可能需要以下内容：

{
  "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：排查失败的部署

开发

从源码构建

# 克隆仓库
git clone https://github.com/pashvc/mcp-server-coolify.git
cd mcp-server-coolify

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

开发脚本

  • npm run build：构建 TypeScript 项目
  • npm run watch：构建并监视更改
  • npm test：运行所有测试
  • npm run test:watch：以监视模式运行测试
  • npm run test:coverage：运行带有覆盖率报告的测试
  • npm run test:integration：仅运行集成测试（需要环境变量）
  • npm run inspector：启动 MCP Inspector 以进行调试

故障排除

常见问题

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

测试您的设置

# 使用您的凭据测试
export COOLIFY_BASE_URL="https://your-coolify-instance.com"
export COOLIFY_TOKEN="your-api-token"

# 运行集成测试以验证连接性
npm run test:integration

# 或直接测试服务器
npm run build && npm start

API 兼容性

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

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

许可证

MIT