SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台coolify-mcp

coolify-mcp

coolify-mcp 是一个面向 Coolify 自托管 PaaS 的 MCP 服务器，提供 64 个工具用于部署、诊断和管理应用、数据库与服务。其类型与 schema 直接由 Coolify 官方 OpenAPI 规范生成，确保工具输入与 API 实际接受的内容一致。主要能力包括：从零创建项目、环境、服务器和应用在内的完整部署工作流；支持 public git、GitHub App、Deploy Key、Dockerfile 和 Docker Image 五种应用类型，以及通过 createService 进行 Docker Compose 部署；环境变量的完整增删改查与密钥遮蔽；应用部署、启动、停止、重启控制；通过 diagnoseApp 进行诊断；内置本地索引的文档全文搜索；写入保护、密钥遮蔽和 MCP 注解等安全特性。

访问官网

工具介绍

用途

coolify-mcp 是一个基于 Coolify API 的 MCP 服务器，用于在自托管 PaaS 上实现从零到生产的完整部署工作流。它面向 Coolify v4.3.10 API，类型与 schema 直接从 Coolify 官方 OpenAPI 规范生成，因此工具输入始终与 API 实际接受的内容保持一致。

主要能力

  • 完整部署工作流：可从头创建项目、环境、服务器和应用。
  • 5 种应用类型：单个 createApplication 工具覆盖 public git、GitHub App、Deploy Key、Dockerfile 和 Docker Image 来源；Docker Compose 部署通过 createService 完成（自 Coolify v4.1 起，compose 部署属于 services）。
  • 环境管理：环境变量的完整 CRUD，支持密钥遮蔽。
  • 部署控制：部署（可选择等待终态状态，失败时附带日志尾部）、启动、停止、重启应用。
  • 诊断：diagnoseApp 可通过 UUID、名称或域名查找应用，并聚合状态、近期部署、失败日志尾部、运行时日志和建议的后续操作。
  • 文档搜索：searchDocs 在捆绑的本地索引中对官方 Coolify 文档进行全文搜索，无需网络。
  • 安全：写入保护、密钥脱敏，以及 MCP 注解（readOnlyHint / destructiveHint），使客户端可自动批准读取操作并对破坏性调用进行门控。
  • 接近完整的 API 覆盖：数据库（8 种引擎、备份、环境变量）、服务、存储、计划任务、团队、预览、服务器、SSH 密钥和 GitHub Apps。
  • 令牌高效：65 个工具的定义约占 ~9k tokens 上下文，并针对由 Coolify OpenAPI 规范生成的 schema 执行严格的运行时校验。

使用方式

使用前需要一个 Coolify API token（在 Coolify 仪表盘的 Settings > API 中获取）。

支持的接入方式包括：

  • Claude Desktop 一键安装：从最新 release 下载 coolify-mcp.mcpb 并拖入 Settings → Extensions，随后按提示填写 Coolify URL 和 token，无需 Node 安装，也无需编辑 JSON。
  • Claude Code CLI。
  • OpenAI Codex CLI，或编辑 ~/.codex/config.toml。
  • 手动配置（~/.mcp.json）。
  • 环境变量配置。

部署示例与工具参考

借助该 MCP，可以从零部署一个应用。工具按主题分组：项目与环境、服务器与基础设施、应用（读取）、应用（创建）、应用（管理）、存储/计划任务/预览、团队/服务器/Git，以及批量操作。Docker Compose 部署通过 createService 并传入 docker_compose_raw 创建，因为自 Coolify v4.1 起它们属于服务，而非应用。数据库和服务的环境变量有各自独立的工具：databaseEnvs 和 serviceEnvs。

安全特性

  • 写入保护：可禁用所有写操作，通过环境变量控制。
  • 密钥处理：环境变量值默认遮蔽，数据库凭据被脱敏，仅在必要时使用 showSecrets: true。
  • HTTP 传输加固：HTTP 传输默认绑定到 127.0.0.1。若要暴露到回环之外，需设置 MCP_HTTP_TOKEN，此后对 /mcp 的每个请求都必须携带 Authorization: Bearer <token>（以常量时间检查），绑定同时切换为 0.0.0.0（可用 MCP_HTTP_HOST 覆盖）。在没有令牌的情况下绑定到非回环主机时会记录一条显眼警告：任何能访问该端口的人都能控制你的 Coolify 实例。
  • 破坏性删除需人工确认：在支持 elicitation 的 MCP 客户端（Claude Code、VS Code Copilot）上，删除项目、应用、数据库、服务、服务器或私钥前会要求确认，并说明将丢失什么。不支持 elicitation 的客户端行为与之前一致。拒绝、取消或超时会中止调用；设置 COOLIFY_MCP_ELICITATION=off 可完全禁用提示。

版本锁定与更新

Coolify 目标版本定义在 src/coolify/constants.ts。更新流程：编辑 src/coolify/constants.ts 中的 COOLIFY_VERSION，然后运行 npm run generate。

限制与说明

当前资料未提供价格、收费模式、性能指标或具体的使用效果数据，暂未提供。使用前应确保具备 Coolify API token，并注意破坏性操作的人工确认与 HTTP 传输的安全配置。

同类工具

查看分类