# Coolify MCP 服务器

最全面的 Coolify 模型上下文协议（MCP）服务器。使 Claude、Cursor 和 Claude Code 等 AI 助手能够通过自然语言管理您的自托管平台即服务（PaaS）—— 部署应用、调试基础设施、执行批量操作以及搜索文档。

Canonical URL: https://a2a-mcp.org/entry/coolify-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-04-01

## 概述

**Coolify MCP 服务器** 是专为 [Coolify](https://coolify.io/) 构建的领先社区版模型上下文协议 (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）

```bash
# 针对 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 的快速单行命令**：
```bash
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对话化且轻松无忧。

## Tags

- coolify
- mcp
- paas
- 自托管
- 部署
- 开发运维
- 人工智能集成
- claude
- cursor
- 基础设施

## Sources

- [Project website](https://github.com/StuMason/coolify-mcp)