AI导哈

Coolify MCP 服务器管理协议

Coolify MCP 是一个用于管理自托管基础设施（服务器、应用程序、数据库、服务及部署）的模型上下文协议服务器，可通过AI助手（如Claude）进行操作。

  • by ofeser
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ofeser/coolify-mcp

使用说明

冷却mcp

MCP（模型上下文协议）服务器 冷却 API通过Claude等人工智能助手管理您的自托管基础设施——服务器、应用程序、数据库、服务和部署。

快速开始

使用npx（推荐）

无需安装。配置您的MCP客户端：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@ofeser/coolify-mcp"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-api-token"
      }
    }
  }
}

全局安装

npm install -g @ofeser/coolify-mcp

然后使用 coolify-mcp 作为MCP客户端配置中的命令。

配置

变量 必填 描述
COOLIFY_API_URL 是 您的Coolify实例URL（例如。 https://coolify.example.com)
COOLIFY_API_TOKEN 是 来自Coolify设置>API的API令牌

获取您的API代币

  1. 转到Coolify仪表板
  2. 导航到 设置 > API
  3. 生成新令牌
  4. 复制令牌并将其设置为 COOLIFY_API_TOKEN

客户端设置

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@ofeser/coolify-mcp"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-api-token"
      }
    }
  }
}

克劳德代码

claude mcp add coolify -- npx -y @ofeser/coolify-mcp

然后在shell中设置环境变量或 .env 文件。

光标

增添 .cursor/mcp.json 在您的项目中：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@ofeser/coolify-mcp"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具

服务器

管理服务器：列出、获取、创建、更新、删除、验证、资源、域。

动作 描述
list 列出所有服务器
get 通过UUID获取服务器详细信息
create 创建新服务器
update 更新服务器配置
delete 删除服务器
validate 验证服务器连接
resources 列出服务器上部署的资源
domains 获取域到IP的映射

应用

管理应用程序：列表、获取、创建（6种源类型）、更新、删除、日志、启动、停止、重新启动。

动作 描述
list 列出所有应用程序
get 通过UUID获取应用程序详细信息
create 创建应用程序（需要 source_type)
update 更新应用程序配置
delete 删除应用程序
logs 获取应用程序日志
start 启动应用程序
stop 停止应用程序
restart 重新启动应用程序

创建的源类型： public, private-github-app, private-deploy-key, dockerfile, dockerimage, dockercompose

数据库

管理数据库：列表、获取、创建（8种数据库类型）、更新、删除、启动、停止、重新启动、备份管理。

动作 描述
list 列出所有数据库
get 通过UUID获取数据库详细信息
create 创建数据库（需要 db_type)
update 更新数据库配置
delete 删除数据库
start 启动数据库
stop 停止数据库
restart 重新启动数据库
list_backups 列出计划备份
create_backup 创建备份计划
update_backup 更新备份计划
delete_backup 删除备份计划
list_backup_executions 列出备份执行情况
delete_backup_execution 删除备份执行

数据库类型： postgresql, mysql, mariadb, mongodb, redis, clickhouse, dragonfly, keydb

服务

管理服务：列表、获取、创建、更新、删除、启动、停止、重新启动。

项目

管理项目：列表、获取、创建、更新、删除。

环境

管理项目环境：列表、获取、创建、删除。

部署

管理部署：列表、获取、部署、取消、list_by_app。

env_vars

管理应用程序或服务的环境变量：列表、创建、更新、update_bulk、删除。

私人钥匙

管理SSH密钥：列表、获取、创建、更新、删除。

团队

管理团队：列表、获取、当前、当前成员、成员。

系统

系统操作：版本、健康检查。

github应用程序

管理GitHub应用程序：列表、获取、创建、更新、删除。

cloud_tokes

管理云提供商令牌：列表、获取、创建、更新、删除、验证。

资源

列出所有项目和环境中的所有资源。

API覆盖范围

类别 操作 状态
服务器 列表、获取、创建、更新、删除、验证、资源、域 已满
应用程序 列表、获取、创建（6种类型）、更新、删除、日志、启动、停止、重新启动 完整
数据库 列表、获取、创建（8种类型）、更新、删除、启动、停止、重新启动、备份 完整
服务 列表、获取、创建、更新、删除、启动、停止、重新启动 完整
项目 列表、获取、创建、更新、删除 完整
环境 列表、获取、创建、删除 完整
部署 列表、获取、部署、取消、按应用程序列表 完整
环境变量 列表、创建、更新、批量更新、删除 完整
SSH密钥 列表、获取、创建、更新、删除 完整
团队 列表、获取、当前、成员 完整
系统 版本，健康检查 完整
GitHub Apps 列表、获取、创建、更新、删除 完整
云令牌 列表、获取、创建、更新、删除、验证 完整
资源 列表 完整

14个工具，85+个操作，100%Coolify API覆盖范围

路线图

  • []Hetzner云服务器配置
  • []每种资源类型的详细Zod模式，以获得更好的AI指导
  • []MCP资源（将服务器/应用程序状态作为可读资源公开）
  • []MCP提示（常见工作流的预构建提示）
  • []大型有效载荷的响应优化

贡献

欢迎投稿！请随时提交拉取请求。

  1. 克隆该仓库
  2. 创建功能分支(git checkout -b feature/new-tool)
  3. 提交您的更改(git commit -m 'Add new tool')
  4. 推到分支(git push origin feature/new-tool)
  5. 打开拉取请求

许可证

麻省理工学院

相关 MCP