Coolify MCP 服务器

概述

Coolify MCP 服务器 是专为 Coolify 构建的领先社区版模型上下文协议 (MCP) 服务器。Coolify 是流行的开源自托管平台即服务 (PaaS)，可替代 Heroku、Vercel 和 Netlify。该服务器允许 AI 编程助手（如 Claude Desktop、Cursor、Claude Code 等）使用自然语言命令完全管理和调试您的 Coolify 实例。

凭借 38 个高度优化的工具、智能资源查找（按名称/域名/IP 而非 UUID）、高效利用令牌的响应以及内置全文文档搜索功能，它将您的 AI 转变为自托管部署的强大 DevOps 协同驾驶员。

核心特性

,

• 38 个优化工具：涵盖基础设施、服务器、项目、应用程序、数据库、服务、部署、环境变量、私钥、团队、云服务令牌（Hetzner、DigitalOcean）等。
• 智能诊断：支持 diagnose_app、diagnose_server、find_issues 等命令，使用人性化标识符。
• 批量操作：重启整个项目、批量更新环境变量、停止/重新部署多个应用程序。
• 令牌高效性：响应内容比原始 Coolify API 小 85-99%（例如，list_applications 从约 170KB 减少到约 4.4KB）。
• 全文文档搜索：内置搜索功能，覆盖 1500+ 个 Coolify 文档片段。
• HATEOAS 风格响应：包含建议的后续操作和分页，以提供更好的 AI 上下文。
• 生产就绪：测试覆盖率超过 98%，使用严格的 TypeScript，具备稳健的错误处理机制。

使用场景

• AI 驱动部署：“将我的 Next.js 应用从 GitHub 仓库 X 部署到生产环境。”
• 基础设施管理：“列出所有服务器，显示资源使用情况，并重启数据库服务器。”
• 调试与诊断：“诊断我的应用失败的原因并提供修复建议。”
• 批量管理：“更新项目 Y 中所有应用的环境变量并重新部署。”
• 文档辅助：“搜索 Coolify 文档以了解如何设置 PostgreSQL 备份。”
• 完整 DevOps 工作流：与其他 MCP 服务器结合，实现端到端由 AI 编排的部署流程。

安装（最简方式）

通过 npx（推荐用于 Claude Desktop / Cursor / Claude Code）

# 针对 Claude Desktop – 添加到 claude_desktop_config.json 文件
npx -y @masonator/coolify-mcp

设置以下环境变量：

• COOLIFY_ACCESS_TOKEN（您的 Coolify API 令牌）
• COOLIFY_BASE_URL（例如 https://your-coolify-instance.com ）

Claude Code 的快速单行命令：

claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://your-coolify.com -- npx @masonator/coolify-mcp@latest

完整源代码及 Docker/手动安装方式可在代码仓库中找到。

兼容性

. …

• 客户端：Claude Desktop、Cursor、Claude Code 及任何符合 MCP 标准的 AI 工具。
• Coolify 版本：已通过 v4.0.0-beta.460+ 版本测试（自动检测功能）。
• 许可证：MIT

社区与替代方案

这是目前维护最活跃、功能最完善的实现版本（截至2026年2月发布v2.7.3），已发布至官方MCP注册中心。如需额外部署工具，增强版分支（如 dazeb/coolify-mcp-enhanced）提供了补充功能。

立即用AI开启您的自托管PaaS管理之旅——Coolify MCP服务器让DevOps对话化且轻松无忧。