# Coolify MCP 伺服器

最全面的 Coolify 模型上下文協議 (MCP) 伺服器。讓 Claude、Cursor 與 Claude Code 等 AI 助手能管理您的自託管 PaaS——透過自然語言部署應用程式、偵錯基礎設施、執行批次操作及搜尋文件。

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

Language: zh-TW

Category: MCP Servers

Updated: 2026-04-01

## 概述

**Coolify MCP 伺服器** 是為 [Coolify](https://coolify.io/) 打造的首席社群建構 Model Context Protocol (MCP) 伺服器。Coolify 是一個受歡迎的開源自託管 PaaS，可作為 Heroku、Vercel 和 Netlify 的替代方案。此 MCP 伺服器允許 AI 編碼助手（如 Claude Desktop、Cursor、Claude Code 等）使用自然語言指令，完全管理和偵錯您的 Coolify 實例。

憑藉 **38 個高度優化的工具**、智能資源查找（使用名稱/網域/IP 而非 UUID）、節省權杖的回應，以及內建的全文文件搜尋功能，它能將您的 AI 助手轉變為管理自託管部署的強大 DevOps 協作夥伴。

## 主要功能



- **38 個優化工具**：涵蓋基礎設施、伺服器、專案、應用程式、資料庫、服務、部署、環境變數、私密金鑰、團隊、雲端權杖（Hetzner、DigitalOcean）等。
a
- **智能診斷**：`diagnose_app`、`diagnose_server`、`find_issues` 使用人性化的識別碼。
c
- **批次操作**：重新啟動整個專案、批量更新環境變數、停止/重新部署多個應用程式。
o
- **權杖效率**：回應比原始 Coolify API 小 85–99%（例如，`list_applications` 從約 170KB 減少至約 4.4KB）。
o
- **全文文件搜尋**：內建搜尋功能，涵蓋 1,500+ 個 Coolify 文件片段。
l
- **HATEOAS 風格回應**：包含建議的後續操作和分頁，以提供更好的 AI 上下文。
i
- **生產環境就緒**：98%+ 的測試覆蓋率，嚴格的 TypeScript，穩健的錯誤處理。
f
y
## 使用案例

- **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/手動設定方式可在儲存庫中找到。

## 相容性

-P
- **客戶端**：Claude Desktop、Cursor、Claude Code，任何符合 MCP 標準的 AI 工具。
o
1. **Coolify 版本**：已針對 v4.0.0-beta.460+ 進行測試（自動偵測功能）。
c
2. **授權條款**：MIT

## 社群與替代方案

這是目前最積極維護且功能最豐富的版本（截至2026年2月為v2.7.3），已發布至官方MCP註冊中心。如需額外的部署工具，可參考強化分支版本（例如 dazeb/coolify-mcp-enhanced）。

現在就開始用AI管理你的自託管PaaS平台吧！Coolify MCP 伺服器讓 DevOps 變成交談式且輕鬆無壓力的體驗。

## Tags

- coolify
- mcp
- paas
- 自託管
- 部署
- devops
- ai-整合
- claude
- cursor
- 基礎設施

## Sources

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