AI导哈

部署管理工具

Coolify MCP是一个用于管理项目部署、资源和环境变量的CLI工具，支持GitHub集成和持久化认证。

  • by AnEntrypoint
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AnEntrypoint/coolify-mcp

使用说明

冷却MCP

用于Coolify CLI的MCP服务器-列出项目、资源、管理部署和配置环境变量。

特性

  • 项目与资源：列出项目和项目资源
  • 应用程序日志：获取运行时或部署日志
  • 应用程序状态：使用可选的部署历史记录获取状态
  • GitHub集成：列出GitHub应用程序和存储库
  • 部署：从私有GitHub仓库部署，使用选项重新部署
  • 环境变量：列出、创建、更新、删除开发周期的环境变量
  • 持久身份验证：API令牌自动保存到 ~/.coolify-mcp/config.json

安装

添加到克劳德代码（推荐）

claude mcp add -s user coolify npx -y gxe@latest AnEntrypoint/coolify-mcp

使用gxe直接执行

npx -y gxe@latest AnEntrypoint/coolify-mcp

本地开发

git clone https://github.com/AnEntrypoint/coolify-mcp.git
cd coolify-mcp
npm install
node index.js

快速开始

  1. 获取API令牌 从https://coolify.247420.xyz/security/api-tokens
  2. 设置令牌 使用 set_api_token 每个会话一次工具
  3. 调用任何工具 与Coolify互动

API令牌设置

要获取API令牌，请执行以下操作：

  1. 引导到https://coolify.247420.xyz/security/api-tokens
  2. 点击“创建”按钮
  3. 输入描述（例如，“mcp工具令牌”）
  4. 选择权限（建议使用“root”进行完全访问）
  5. 点击“创建”
  6. 立即复制令牌 （只显示一次！）

令牌会自动保存到 ~/.coolify-mcp/config.json 并在会话之间持续。

工具（共12个）

项目与资源管理

list_项目

列出Coolify项目或获取项目资源。

输入：

  • project_id （string，可选）-如果设置了，则获取资源

输出： 一系列项目或带有应用程序的项目

日志和状态

get_app_logs

获取应用程序日志（运行时或部署）。

输入：

  • app_uuid （字符串，必填）-应用程序UUID
  • type （字符串，可选，默认值：“runtime”）-“runtime（运行时）”或“deploy（部署）”
  • lines （数字，可选，默认值：100）-记录行

输出： 日志数据

获取app_status

获取应用程序状态和部署历史记录。

输入：

  • app_uuid （字符串，必填）-应用程序UUID
  • include_deployments （布尔值，可选，默认值：false）-包括部署历史记录
  • skip （数字，可选，默认值：0）-跳过分页
  • take （数字，可选，默认值：50）-分页

输出： 带有可选部署历史记录的应用程序状态

GitHub部署

list_github_apps

列出GitHub应用程序或从GitHub应用程序获取存储库。

输入：

  • github_app_id （字符串，可选）-如果设置，则获取repos

输出： GitHub应用程序或存储库数组

create_application_github

从私有GitHub仓库部署应用程序。

输入： （必填）

  • project_uuid, server_uuid, github_app_uuid, git_repository, git_branch, ports_exposes

可选：

  • name, description, build_pack, instant_deploy, base_directory, build_command, start_command

输出： 已创建应用程序对象

重新部署应用程序

重新部署应用程序。

输入：

  • app_uuid （字符串，必填）-应用程序UUID
  • force （布尔值，可选）-强制重建
  • instant_deploy （布尔值，可选）-跳过部署队列

输出： 部署响应

环境变量（CRUD）

list_env_变量

列出应用程序环境变量。

输入：

  • app_uuid （字符串，必填）-应用程序UUID

输出： 具有UUID和设置的环境变量数组

create_env变量

将环境变量添加到应用程序中。

输入： （必填）

  • app_uuid, key, value

可选：

  • is_buildtime （布尔值，默认值：true）
  • is_runtime （布尔值，默认值：true）
  • is_preview, is_literal

输出： 已创建环境变量

update_env_variable

编辑应用程序环境变量。

输入： （必填）

  • app_uuid, env_uuid

可选：

  • key, value, is_buildtime, is_runtime, is_preview, is_literal

输出： 更新环境变量

delete_env_variable

删除应用程序环境变量。

输入： （必填）

  • app_uuid, env_uuid

输出： 成功确认

认证

set_api_token

设置Coolify API令牌进行身份验证。

输入：

  • token （字符串，必需）-来自Coolify的API令牌

输出：

{
  "success": true,
  "message": "API token saved successfully"
}

配置

配置存储在 ~/.coolify-mcp/config.json:

{
  "apiToken": "3|your-token-here"
}

令牌通过以下方式自动保存 set_api_token 工具，并在会话中持久化。

开发周期工作流示例

1. list_env_variables          → See current configuration
2. update_env_variable         → Adjust settings (build, runtime, etc)
3. redeploy_application        → Test changes (force rebuild)
4. get_app_logs type=deploy    → Check deployment status
5. get_app_status              → Verify app health

安全

  • 令牌存储：本地存储在 ~/.coolify-mcp/config.json
  • 无日志：除了Coolify服务器，令牌从未记录
  • 代币轮换：定期轮换代币https://coolify.247420.xyz/security/api-tokens

建筑

  • 用途 @modelcontextprotocol/sdk 用于MCP协议
  • 通过stdio（stdin/stdout）进行通信
  • 兼容任何MCP客户端（Claude Code等）
  • 除了npm包之外没有外部依赖

许可证

麻省理工学院

相关 MCP