From jurislm-claude-plugins-coolify
This skill should be used when the user asks to "deploy to Coolify", "manage Coolify applications", "check Coolify status", "create database on Coolify", "manage Coolify servers", "diagnose Coolify issues", "update environment variables on Coolify", or mentions Coolify deployment, infrastructure management, or self-hosted PaaS operations.
npx claudepluginhub terry90918/jurislm-claude-pluginsThis skill uses the workspace's default tool permissions.
Coolify 是一個開源的自託管 PaaS(Platform as a Service),類似於 Heroku 或 Vercel。此 skill 提供透過 MCP 工具管理 Coolify 基礎設施的完整指南。
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Coolify 是一個開源的自託管 PaaS(Platform as a Service),類似於 Heroku 或 Vercel。此 skill 提供透過 MCP 工具管理 Coolify 基礎設施的完整指南。
jurislm-coolify-mcp 提供 35 個最佳化工具,分為以下類別:
| 類別 | 功能 |
|---|---|
| 基礎設施 | 版本檢查、基礎設施概覽 |
| 診斷 | 應用/伺服器診斷、問題掃描 |
| 伺服器 | 列表、詳情、資源、域名、驗證 |
| 應用程式 | CRUD、日誌、環境變數、控制 |
| 資料庫 | 8 種類型、備份排程管理 |
| 服務 | 建立、更新、刪除、控制 |
| 部署 | 列表、部署、取消、狀態 |
| 批量操作 | 重啟專案、環境變數更新、全面停止 |
理解 Application 和 Service 的差異對於正確使用 Coolify 至關重要:
| 類型 | 說明 | FQDN 更新 |
|---|---|---|
| Application | 單一應用程式(Git/Dockerfile/Docker Image) | ✅ 可透過 API 更新 |
| Service | Docker Compose 組合(含多個容器) | ⚠️ 需修改 docker_compose_raw |
docker_compose_raw 中的 Traefik labels 控制docker_compose_raw 中的 Traefik labelscoolify_service update 更新❌ 嘗試用 coolify_application update 更新 Service 內的 App FQDN
✅ 正確做法:更新整個 Service 的 docker_compose_raw
除了 UUID,MCP 支援人類易讀識別符:
stuartmason.co.uk 而非 UUID192.168.1.100 而非 UUIDcoolify_infrastructure_overview 查看可用伺服器和專案coolify_create_application 建立應用程式coolify_update_env_vars 設定環境變數coolify_deploy 觸發部署coolify_deployment_status 監控部署進度coolify_scan_for_issues 掃描基礎設施問題coolify_diagnose_application 診斷特定應用程式coolify_get_application_logs 查看應用程式日誌coolify_server_resources 檢查伺服器資源coolify_list_databases 列出所有資料庫coolify_create_database 建立新資料庫(支援 PostgreSQL、MySQL、MongoDB、Redis 等)coolify_manage_backup_schedule 設定備份排程coolify_restart_project_apps - 重啟專案中所有應用程式coolify_batch_env_update - 批量更新環境變數coolify_stop_all - 停止所有服務(維護用)使用前需設定以下環境變數:
# ~/.zshenv
export COOLIFY_ACCESS_TOKEN="your-api-token"
export COOLIFY_BASE_URL="https://your-coolify-instance.com"
取得 API Token:Coolify Dashboard → Settings → API Tokens → Generate
health_check_path 確保平滑更新coolify_server_resources 監控資源使用coolify_scan_for_issues 定期檢查問題coolify_get_application_logscoolify_server_resourcescoolify_diagnose_application每次部署新應用前,逐項確認:
DATABASE_URI 已設定且特殊字元已 URL-encode(! → %21)DATABASE_URI for Payload CMS)coolify_server_resourcescoolify_get_application_logs詳細資訊請參閱:
references/api-reference.md - 完整 API 端點文件references/deployment-patterns.md - 部署模式與最佳實踐references/troubleshooting.md - 詳細故障排除指南