适合谁
- 使用 Coolify 自托管 PaaS 的开发者和运维人员。
- 希望通过 AI 助手简化日常部署和运维任务的团队。
- 需要在多个 Coolify 实例间操作的场景。
C
68FMRS · C
Coolify MCP Server 是一个功能全面、设计精良的 MCP 服务器，专为管理 Coolify 自托管 PaaS 设计。它通过整合工具和 token 优化，减少了上下文消耗，同时提供了安全的默认行为和人工确认机制。适合希望使用 AI 助手简化运维工作的用户。
Coolify MCP Server 是一个 MCP 服务器，允许 AI 助手（如 Claude、Cursor）通过自然语言管理 Coolify 实例。它提供了 44 个整合的工具，涵盖基础设施概览、诊断、部署、环境变量管理、数据库、服务、备份、定时任务等。设计上注重 token 效率，使用 action 参数合并工具，减少上下文占用。支持安全的默认行为，包括敏感信息掩码和破坏性操作的人工确认。兼容 Coolify v4.0 至 v4.2+，适用于自托管 PaaS 的运维。
工具能力
get_infrastructure_overview
获取整个基础设施的概览。
get_mcp_version
获取 MCP 服务器自身的版本信息。
get_version
获取 Coolify 实例的版本。
system
系统操作，如健康检查、列出资源、启用/禁用 API。
diagnose_app
诊断指定应用，可通过 UUID、名称或域名查找。
diagnose_server
诊断指定服务器，可通过 UUID、名称或 IP 查找。
find_issues
在基础设施中查找潜在问题。
restart_project_apps
重启一个项目中的所有应用。
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 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"
}
}
}
}
选型与风险
不适合谁
- 没有 Coolify 实例的用户。
- 需要完全自动化且无人工确认的破坏性操作（但可通过 COOLIFY_MCP_ELICITATION=off 关闭确认）。
- 部署到不兼容的 Coolify 版本（仅支持 v4.0 及以上）。
所需权限
- 需要 Coolify API 访问令牌（COOLIFY_ACCESS_TOKEN），该令牌的权限决定了 MCP 能执行的操作。
- 可以读取和修改应用、数据库、服务、环境变量等资源。
- 破坏性操作（如删除、停止）会触发人工确认，除非关闭。
风险与副作用
- 如果 API 令牌权限过大，可能导致意外删除或停止资源。
- 破坏性操作可能造成数据丢失，但工具提供确认机制以降低风险。
- 敏感信息（如密码、密钥）默认会被掩码，但若开启 reveal 可能有泄露风险。
常见排障
- 确保 COOLIFY_BASE_URL 和 COOLIFY_ACCESS_TOKEN 设置正确。
- 检查 Coolify 版本是否在 v4.0 及以上。
- 如果确认提示超时，提高客户端的 MCP 工具超时时间。
- 如果收到 403 错误，检查令牌是否具有写入权限。
- 如果 reveal: true 返回空值，可能需要具有 sensitive-read 权限的令牌。
使用场景
通过自然语言管理 Coolify 上的应用、数据库和服务。
快速诊断应用或服务器问题并获取建议。
批量操作，如重启项目中的所有应用或停止所有应用。
管理环境变量、存储、定时任务和备份。
搜索 Coolify 文档以获取帮助。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持