Coolify MCP Server

社区

用于管理自托管 PaaS 平台 Coolify 的 MCP 服务器，提供 44 个优化工具。

分类: 开发工具第 20 / 438
Stars: ★ 611 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 今天
工具数: 44

68FMRS · C

Coolify MCP Server 是一个功能全面、设计精良的 MCP 服务器，专为管理 Coolify 自托管 PaaS 设计。它通过整合工具和 token 优化，减少了上下文消耗，同时提供了安全的默认行为和人工确认机制。适合希望使用 AI 助手简化运维工作的用户。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

14/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 源代码包含测试和CI工作流，表明核心路径是可复现的。但静态审查无法执行验证，且错误处理、边界情况在文档中提及但未充分展示。因此得分不超过12。
安全与权限 15/20: 服务器遮蔽敏感字段，默认为破坏性操作提供确认，并依赖elicitation。未发现恶意行为。但确认机制依赖于客户端支持，且存在逃避机制（COOLIFY_MCP_ELICITATION=off），可能降低安全性。未发现红色警报。
维护活跃度 14/20: 仓库活跃，有定期发布、CI和许可证。但未看到安全响应渠道或明确的治理政策。
文档质量 15/20: README全面，包含安装、认证、工具列表、设计原则和安全实践。有示例和故障排除。但某些工具参数细节可能依赖'运行无参数'来发现，可能存在隐藏假设。
安装易用性 14/20: 提供多种安装方式（一键安装、npm、JSON配置），有明确的客户端配置示例。依赖Node.js和npx，但未提及具体运行要求。静态审查无法验证安装过程，因此得分不高。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Coolify 自托管 PaaS 的开发者和运维人员。
希望通过 AI 助手简化日常部署和运维任务的团队。
需要在多个 Coolify 实例间操作的场景。

不适合谁

没有 Coolify 实例的用户。
需要完全自动化且无人工确认的破坏性操作（但可通过 COOLIFY_MCP_ELICITATION=off 关闭确认）。
部署到不兼容的 Coolify 版本（仅支持 v4.0 及以上）。

所需权限

需要 Coolify API 访问令牌（COOLIFY_ACCESS_TOKEN），该令牌的权限决定了 MCP 能执行的操作。
可以读取和修改应用、数据库、服务、环境变量等资源。
破坏性操作（如删除、停止）会触发人工确认，除非关闭。

风险与副作用

如果 API 令牌权限过大，可能导致意外删除或停止资源。
破坏性操作可能造成数据丢失，但工具提供确认机制以降低风险。
敏感信息（如密码、密钥）默认会被掩码，但若开启 reveal 可能有泄露风险。

安装接入

准备工作

运行环境：Node.js

COOLIFY_ACCESS_TOKEN 必填密钥 Coolify API 访问令牌，在 Coolify → Settings → API 中创建，需具备相应读写权限。

其他可选配置项（2 个）

COOLIFY_BASE_URL 可选你的 Coolify 实例 URL，例如 https://your-coolify-instance.com。

COOLIFY_MCP_ELICITATION 可选设为 off 可关闭破坏性操作的人工确认，仅用于客户端声称支持 elicitation 却未真正实现的情形。

确保你有可用的 Coolify v4 实例和 API 令牌（Coolify → Settings → API）。
对于 Claude Desktop：下载 coolify-mcp.mcpb 文件并拖入 Settings → Extensions，按提示输入 Coolify URL 和令牌。
对于 Claude Code：运行 claude mcp add coolify -e COOLIFY_BASE_URL="..." -e COOLIFY_ACCESS_TOKEN="..." -- npx @masonator/coolify-mcp@latest。
对于其他 MCP 客户端：在 JSON 配置中添加 mcpServers 条目，设置命令为 npx，参数为 ['-y', '@masonator/coolify-mcp']，并设置环境变量 COOLIFY_BASE_URL 和 COOLIFY_ACCESS_TOKEN。
可选：如遇 Cloudflare Access 或代理，可添加 --header 参数。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add coolify -e COOLIFY_BASE_URL=https://your-coolify-instance.com -e COOLIFY_ACCESS_TOKEN=your-api-token -- npx -y @masonator/coolify-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中连接后，应出现 coolify 服务器的 44 个工具（如 get_infrastructure_overview、list_servers、search_docs）。可运行 get_infrastructure_overview 或 list_servers，能返回你的 Coolify 实例数据即证明连接成功。

常见排障

确保 COOLIFY_BASE_URL 和 COOLIFY_ACCESS_TOKEN 设置正确。
检查 Coolify 版本是否在 v4.0 及以上。
如果确认提示超时，提高客户端的 MCP 工具超时时间。
如果收到 403 错误，检查令牌是否具有写入权限。
如果 reveal: true 返回空值，可能需要具有 sensitive-read 权限的令牌。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

给我一个基础设施的整体概览
诊断我的 stuartmason.co.uk 应用
部署应用并等待完成
重启项目中的所有应用程序

工具能力 44

get_infrastructure_overview 只读

获取整个基础设施的概览。

get_mcp_version 只读

获取 MCP 服务器自身的版本信息。

get_version 只读

获取 Coolify 实例的版本。

system 写入

系统操作，如健康检查、列出资源、启用/禁用 API。

diagnose_app 只读

诊断指定应用，可通过 UUID、名称或域名查找。

diagnose_server 只读

诊断指定服务器，可通过 UUID、名称或 IP 查找。

find_issues 只读

在基础设施中查找潜在问题。

restart_project_apps 写入

重启一个项目中的所有应用。

展开其余 36 个工具

bulk_env_update 写入

批量更新环境变量（支持多个应用）。

stop_all_apps 破坏性

停止所有应用（破坏性操作，需确认）。

redeploy_project 写入

重新部署整个项目（破坏性操作，需确认）。

list_servers 只读

列出所有服务器。

get_server 只读

获取服务器详细信息。

validate_server 只读

验证服务器配置。

server_resources 只读

列出服务器上的资源（应用、数据库等）。

server_domains 只读

列出服务器上的域名。

projects 写入

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

environments 写入

环境管理：列出、获取、创建、删除环境。

list_applications 只读

列出所有应用。

get_application 只读

获取应用详细信息。

application 写入

应用 CRUD 操作及删除预览。

list_databases 只读

列出所有数据库。

get_database 只读

获取数据库详细信息。

database 写入

数据库 CRUD 操作，支持 8 种类型创建和删除。

database_backups 写入

数据库备份管理：CRUD 备份计划、执行记录（含删除）。

list_services 只读

列出所有服务。

get_service 只读

获取服务详细信息。

service 写入

服务 CRUD 操作、容器列表、更新和启停等（v4.2+）。

control 写入

启停/重启应用、数据库、服务。

logs 只读

获取容器日志（支持应用、数据库、服务）。

application_logs 只读

获取应用日志（已被 logs 替代）。

tags 写入

标签管理：列出、附加、分离标签，并可按标签部署。

env_vars 写入

环境变量 CRUD 及批量更新（支持应用、服务、数据库）。

storages 写入

存储管理：列出、创建、更新、删除持久化/文件存储。

scheduled_tasks 写入

定时任务管理：列出、创建、更新、删除、执行记录、立即运行。

list_deployments 只读

列出部署记录。

deploy 写入

触发部署，可选择等待至完成并返回日志。

deployment 只读

部署详情、取消、按应用列出部署。

private_keys 写入

私钥管理：列出、获取、创建、更新、删除。

github_apps 写入

GitHub Apps 管理：列出、获取、创建、更新、删除、列出仓库和分支。

teams 只读

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

cloud_tokens 写入

云令牌管理（Hetzner/DigitalOcean）：列出、获取、创建、更新、删除、验证。

hetzner 写入

Hetzner Cloud 操作：列出位置、服务器类型、镜像、SSH 密钥，创建服务器。

search_docs 只读

在 Coolify 文档中进行全文搜索。

使用场景

通过自然语言管理 Coolify 上的应用、数据库和服务。

快速诊断应用或服务器问题并获取建议。

批量操作，如重启项目中的所有应用或停止所有应用。

管理环境变量、存储、定时任务和备份。

搜索 Coolify 文档以获取帮助。

支持客户端

Claude Desktop

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Coolify MCP Server 是一个 MCP 服务器，允许 AI 助手（如 Claude、Cursor）通过自然语言管理 Coolify 实例。它提供了 44 个整合的工具，涵盖基础设施概览、诊断、部署、环境变量管理、数据库、服务、备份、定时任务等。设计上注重 token 效率，使用 action 参数合并工具，减少上下文占用。支持安全的默认行为，包括敏感信息掩码和破坏性操作的人工确认。兼容 Coolify v4.0 至 v4.2+，适用于自托管 PaaS 的运维。