de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🚀 Coolify MCP Server（`coolify-mcp`）

TypeScript Node Version License: MIT Model Context Protocol Coolify API Tools

一个全面的、生产级的 Model Context Protocol (MCP) 服务器，用于 Coolify v4 自托管 PaaS。

将 AI 编程助手和代理（Claude Desktop、Cursor、Antigravity、Claude Code、Windsurf、Cline 和 VS Code）直接连接到您的 Coolify 实例，以编排基础设施、部署应用程序、管理 8 种类型的数据库、处理环境变量，并使用自然语言诊断日志。

🌟 为什么选择 `coolify-mcp`？

🌐 100% 完整的 Coolify v4 API 覆盖：77 个经过验证的 MCP 工具，涵盖项目、环境、服务器、应用程序、数据库、Docker Compose 服务、部署、团队成员和 SSH 密钥。
🔒 只读安全防护：启用 --read-only（或 COOLIFY_READ_ONLY=true）可让 AI 助手在不执行任何变更或破坏性操作的情况下进行审计、监控和故障排查。
🗄️ 通用数据库引擎支持：开箱即用地创建和配置 PostgreSQL、MySQL、MariaDB、MongoDB、Redis、ClickHouse、Dragonfly 和 KeyDB，并支持引擎特定的参数规范化。
📊 动态 MCP 资源：原生资源（coolify://overview、coolify://servers、coolify://applications、coolify://databases），提供零 token 的环境上下文。
💡 DevOps 提示词模板：预构建的提示词配方（diagnose-application、infrastructure-audit、deployment-summary），用于自主诊断和健康检查。
🐳 Docker 与 Stdio 传输就绪：可作为标准 Node CLI 工具运行，也可在支持容器间网络的隔离 Docker 容器中运行。

Related MCP server: Coolify MCP Server

🤖 AI 代理设置提示词（复制粘贴）

如果您正在使用 AI 编程助手（如 Antigravity、Claude Code、Cursor、Windsurf 或 Cline），只需将以下提示词复制粘贴到您的助手中：

Please configure and set up the Coolify MCP server for me from https://github.com/frizikk/coolify-mcp.git.

Follow these steps:
1. Clone the repository:
   git clone https://github.com/frizikk/coolify-mcp.git
2. Install dependencies and build the server:
   cd coolify-mcp && pnpm install && pnpm build
3. Guide me to provide my Coolify instance URL (e.g. https://coolify.my-domain.com or http://localhost:8000) and API Bearer Token (generated in Coolify under Keys & Tokens / Settings -> API).
4. Add the `coolify` server configuration to my MCP client config (e.g., in Claude Desktop `claude_desktop_config.json`, Cursor `~/.cursor/mcp.json`, or Antigravity `~/.gemini/config/mcp_config.json`).
5. Test the connection by calling `coolify_get_version` and `coolify_get_infrastructure_overview` to verify connection to my Coolify instance.

🛠️ MCP 工具参考

该服务器提供 77 个专用工具，涵盖 8 个核心 DevOps 领域：

1. 系统与基础设施概览（4 个工具）

工具	参数	描述
`coolify_get_version`	无	获取正在运行的 Coolify 实例版本字符串。
`coolify_get_health`	无	对 Coolify 后端执行健康检查。
`coolify_list_resources`	无	列出所有项目中管理的所有资源。
`coolify_get_infrastructure_overview`	无	获取聚合的健康状态、服务器状态、应用程序和数据库仪表板。

2. 服务器与节点管理（8 个工具）

工具	参数	描述
`coolify_list_servers`	无	列出所有已注册的服务器及其可达性和可用性标志。
`coolify_get_server`	`uuid`	获取详细的服务器配置、IP 和设置。
`coolify_validate_server`	`uuid`	验证与服务器的 SSH 连接和连通性。
`coolify_get_server_resources`	`uuid`	列出部署到特定服务器的所有资源。
`coolify_get_server_domains`	`uuid`	列出服务器上的所有活动域名和路由。
`coolify_create_server`	`name`、`ip`、`port?`、`user?`、`private_key_uuid?`、`proxy_type?`	注册新的服务器节点。
`coolify_update_server`	`uuid`、`name?`、`description?`、`ip?`、`port?`	更新服务器配置。
`coolify_delete_server`	`uuid`	从 Coolify 中移除服务器。

3. 团队与 SSH 密钥（9 个工具）

工具	参数	描述
`coolify_list_teams`	无	列出令牌可访问的所有团队。
`coolify_get_current_team`	无	获取当前已认证团队的详细信息。
`coolify_get_current_team_members`	无	列出当前团队中的用户和角色。
`coolify_get_team`	`team_id`	按 ID 获取团队详细信息。
`coolify_get_team_members`	`team_id`	按 ID 列出特定团队的成员。
`coolify_list_private_keys`	无	列出所有已注册的 SSH 私钥。
`coolify_get_private_key`	`uuid`	获取私钥详细信息。
`coolify_create_private_key`	`name`、`private_key`、`description?`	注册新的 SSH 私钥（Ed25519/RSA）。
`coolify_delete_private_key`	`uuid`	删除 SSH 私钥。

4. 项目与环境（9 个工具）

工具	参数	描述
`coolify_list_projects`	无	列出所有项目和环境。
`coolify_get_project`	`uuid`	获取项目结构和环境列表。
`coolify_create_project`	`name`、`description?`	创建新项目。
`coolify_update_project`	`uuid`、`name?`、`description?`	更新项目名称或描述。
`coolify_delete_project`	`uuid`	删除空项目。
`coolify_list_environments`	`project_uuid`	列出项目中的环境。
`coolify_get_environment`	`project_uuid`、`environment_name_or_uuid`	获取环境详细信息。
`coolify_create_environment`	`project_uuid`、`name`	创建新环境（`testing`、`staging`）。
`coolify_delete_environment`	`project_uuid`、`environment_name_or_uuid`	删除环境。

5. 应用程序（16 个工具）

工具	参数	描述
`coolify_list_applications`	none	列出所有独立应用。
`coolify_get_application`	`uuid`	获取应用配置、端口和域名。
`coolify_create_application_public_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `build_pack`, `name?`	从公共 Git 仓库部署。
`coolify_create_application_private_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `private_key_uuid`, `build_pack`, `name?`	从私有 Git 仓库部署。
`coolify_create_application_dockerfile`	`project_uuid`, `server_uuid`, `environment_name`, `dockerfile`, `name?`	从原始或 base64 编码的 Dockerfile 部署。
`coolify_create_application_docker_image`	`project_uuid`, `server_uuid`, `environment_name`, `docker_registry_image_name`, `docker_registry_image_tag?`	部署预构建的 Docker 镜像。
`coolify_update_application`	`uuid`, `name?`, `description?`, `domains?`, `build_pack?`, `ports_exposes?`	更新应用配置。
`coolify_delete_application`	`uuid`	删除应用及其容器。
`coolify_start_application`	`uuid`	触发应用的启动/部署。
`coolify_stop_application`	`uuid`	停止正在运行的应用容器。
`coolify_restart_application`	`uuid`	重启应用容器。
`coolify_get_application_logs`	`uuid`	获取运行时容器的 stdout/stderr 日志。
`coolify_list_application_envs`	`uuid`	列出应用的所有环境变量。
`coolify_set_application_env`	`uuid`, `key`, `value`, `is_build_time?`, `is_literal?`	设置/创建环境变量。
`coolify_bulk_set_application_envs`	`uuid`, `envs: [{key, value}]`	批量更新多个环境变量。
`coolify_delete_application_env`	`uuid`, `env_uuid`	按 UUID 删除环境变量。

6. 部署（5 个工具）

工具	参数	描述
`coolify_list_deployments`	none	列出全局运行中和已完成的部署。
`coolify_list_app_deployments`	`app_uuid`	列出指定应用的部署历史。
`coolify_get_deployment`	`deployment_uuid`	获取部署状态、提交信息和日志。
`coolify_trigger_deployment`	`uuid?`, `tag?`, `force?`	触发即时构建和部署。
`coolify_cancel_deployment`	`deployment_uuid`	取消进行中的部署。

7. 数据库（14 个工具）

工具	参数	描述
`coolify_list_databases`	none	列出所有独立数据库。
`coolify_get_database`	`uuid`	获取数据库详情和连接字符串。
`coolify_create_database`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `database_name?`, `database_user?`, `database_password?`, `root_password?`, `is_public?`	创建数据库（PostgreSQL、MySQL、MariaDB、MongoDB、Redis、ClickHouse、Dragonfly、KeyDB）。
`coolify_update_database`	`uuid`, `name?`, `description?`, `is_public?`, `public_port?`	更新数据库设置。
`coolify_delete_database`	`uuid`	删除数据库容器和数据卷。
`coolify_start_database`	`uuid`	启动数据库容器。
`coolify_stop_database`	`uuid`	停止数据库容器。
`coolify_restart_database`	`uuid`	重启数据库容器。
`coolify_get_database_backups`	`uuid`	列出数据库的备份配置。
`coolify_create_database_backup`	`uuid`, `frequency`, `enabled?`, `save_s3?`	安排自动数据库备份（cron）。
`coolify_update_database_backup`	`uuid`, `backup_uuid`, `frequency?`, `enabled?`	更新备份计划设置。
`coolify_delete_database_backup`	`uuid`, `backup_uuid`	删除备份配置。
`coolify_list_backup_executions`	`uuid`, `backup_uuid`	列出备份运行执行历史。
`coolify_delete_backup_execution`	`uuid`, `backup_uuid`, `execution_uuid`	删除特定的备份运行产物。

8. 一键服务与 Docker Compose（12 个工具）

工具	参数	描述
`coolify_list_services`	none	列出所有一键服务。
`coolify_get_service`	`uuid`	获取服务元数据、域名和容器。
`coolify_create_service`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `description?`	部署一键模板（Ghost、Plausible 等）。
`coolify_update_service`	`uuid`, `name?`, `description?`	更新服务设置。
`coolify_delete_service`	`uuid`	删除服务栈。
`coolify_start_service`	`uuid`	启动服务容器。
`coolify_stop_service`	`uuid`	停止服务容器。
`coolify_restart_service`	`uuid`	重启服务栈。
`coolify_list_service_envs`	`uuid`	列出服务环境变量。
`coolify_set_service_env`	`uuid`, `key`, `value`	创建/更新服务环境变量。
`coolify_bulk_set_service_envs`	`uuid`, `envs: [{key, value}]`	批量更新服务环境变量。
`coolify_delete_service_env`	`uuid`, `env_uuid`	删除服务环境变量。

📊 MCP 资源与提示

资源

coolify://overview — 所有服务器、应用、数据库和服务的聚合实时摘要。
coolify://servers — 服务器及其可达状态的实时列表。
coolify://applications — 所有应用和 URL 的实时状态。
coolify://databases — 数据库容器的实时状态。

提示

diagnose-application — 自动化诊断工作流：检查应用状态、分析最近的日志并检查环境变量。
infrastructure-audit — 跨服务器、磁盘限制和故障容器的完整基础设施健康检查。
deployment-summary — 分析最近的部署并呈现构建失败信息。

⚙️ 配置与客户端设置

环境变量

变量	描述	默认值
`COOLIFY_BASE_URL`	你的 Coolify 实例的基础 URL（例如 `https://coolify.example.com`）	`http://localhost:8000`
`COOLIFY_API_TOKEN`	Coolify API Bearer Token	`""`
`COOLIFY_READ_ONLY`	限制为只读操作（`true`/`false`）	`false`

客户端配置示例

1. Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

2. Cursor（`~/.cursor/mcp.json` 或项目的 `.cursor/mcp.json`）

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

3. Antigravity（`~/.gemini/config/mcp_config.json`）

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

4. Docker 容器模式

docker run -i --rm \
  -e COOLIFY_BASE_URL="http://coolify:8080" \
  -e COOLIFY_API_TOKEN="your-bearer-token" \
  --network coolify-network \
  coolify-mcp:latest

🧪 测试与验证

测试套件包括单元测试和针对运行中的 Docker 化 Coolify v4 实例执行的完整端到端集成测试：

# Run all automated unit and integration tests (43 tests)
pnpm test

# Run complete 77-tool live verification suite
pnpm test:verify-live

📄 许可证

根据 MIT 许可证 分发。详见 LICENSE。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp
JustDeployOAuth
ai.justdeploy
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Cloud Platforms CI/CD & DevOps App Automation
2
https://mcp.justdeploy.ai/mcp
microservices.sh
sh.microservices
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Cloud Platforms Agent Orchestration Developer Tools
21
https://api.microservices.sh/mcp
serverOAuth
com.devopness.mcp
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
Cloud Platforms CI/CD & DevOps Developer Tools
3
https://mcp.devopness.com/mcp/

Related MCP Servers

Coolify MCP Server
Cloud Platforms Developer Tools Virtualization
kof70
A
license
B
quality
B
maintenance
Enables control and management of Coolify self-hosted PaaS instances, allowing you to deploy applications, manage databases, monitor servers, and execute operations directly from AI assistants.
Updated a month ago (2026-09-17 18:56 UTC)
89
12 npm
28
MIT
Coolify MCP Server
Cloud Platforms CI/CD & DevOps Developer Tools
JoshuaRileyDev
A
license
B
quality
D
maintenance
Enables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.
Updated a year ago (2025-06-15 17:53 UTC)
18
6 npm
3
MIT
coolify-mcp
Cloud Platforms Databases
jurislm
A
license
Not graded
quality
F
maintenance
MCP server for Coolify infrastructure management, providing 45 tools for servers, applications, databases, deployments, and diagnostics via natural language.
Updated 4 months ago (2026-07-11 05:18 UTC)
32 npm
MIT
coolify-mcp
Cloud Platforms Developer Tools CI/CD & DevOps
0xtlt
A
license
B
quality
A
maintenance
MCP server for managing Coolify instances, enabling control of applications, databases, services, servers, and more via natural language.
Updated 9 days ago (2026-10-22 05:30 UTC)
136
251 npm
MIT

🚀 Coolify MCP Server（coolify-mcp）

🌟 为什么选择 coolify-mcp？