Coolify MCP Server

一个用于管理Coolify部署的模型上下文协议（MCP）服务器，提供程序化的MCP工具和全面的CLI命令。

快速开始

方案1：MCP集成（推荐）

MCP（模型控制协议）允许您直接从AI编辑器中管理Coolify。

1. 添加到您的MCP配置

对于Cursor： 添加到 ~/.cursor/mcp.json 或 <项目文件夹>/.cursor/mcp.json：

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

对于VS Code： 添加到 <项目文件夹>/.vscode/mcp.json：

{
  "servers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      },
      "type": "stdio"
    }
  }
}

🔑 将 your-coolify-instance.com 替换为您实际的Coolify URL，并将 your-coolify-api-token 替换为您从Coolify设置中的API生成的API令牌。

2. （仅限Cursor）启用Coolify MCP

打开Cursor设置（Ctrl+Shift+J）➡ 点击MCP标签➡ 使用切换按钮启用coolify-mcp

3. 开始管理Coolify

在您的AI聊天中尝试以下命令：

列出我的Coolify应用程序
创建一个新的名为“my-blog”的WordPress服务
部署具有ID“app-123”的应用
显示所有可用的数据库类型

方案2：CLI使用

安装

# 全局安装以供CLI使用
npm install -g @felixallistar/coolify-mcp

# 测试安装
coolify-mcp --help

配置

在您的项目目录中创建一个.env文件：

# 必需：您的Coolify实例URL（如有需要，请包含端口）
COOLIFY_API_URL=https://your-coolify-instance.com

# 必需：您的Coolify API令牌（在Coolify设置中的API生成）
COOLIFY_API_TOKEN=your-coolify-api-token

常用命令

# 应用程序管理
coolify-mcp apps list
coolify-mcp apps create-public --name "my-app" --repository "https://github.com/user/repo" --project "project-id"
coolify-mcp apps start app-id

# 服务管理（70多个一键服务）
coolify-mcp services types
coolify-mcp services create --name "my-blog" --type "wordpress-with-mysql" --project "project-id"

# 数据库管理（8种数据库类型）
coolify-mcp databases create-postgresql --name "main-db" --project "project-id"
coolify-mcp databases create-redis --name "cache" --project "project-id"

# 项目管理
coolify-mcp projects list
coolify-mcp projects create --name "My Project"

# 测试连接
coolify-mcp system health

功能

🔄 应用程序（21个操作）

完整的应用程序生命周期管理，包括6种部署类型、环境变量、日志和控制操作。

🔧 服务（14个操作）

70多个一键服务，包括WordPress、Ghost、MinIO等，以及完整的环境管理。

🗄️ 数据库（13个操作）

8种数据库类型：PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly。

📂 项目、服务器、部署

完整的基础设施管理，包括私钥、系统管理和部署监控。

MCP工具与CLI命令

此包提供了两种交互方式，功能完全一致：

• 🤖 MCP工具：适用于AI代理和Cursor集成（推荐）
• 💻 CLI命令：适用于直接终端使用

两个接口提供相同的功能——根据您的工作流程选择。

开发

自动API更新

保持与Coolify最新API同步：

npm run refresh           # 下载最新的API规范并重新构建
npm run check-updates     # 检查API更改

手动开发

git clone https://github.com/FelixAllistar/coolify-mcp.git
cd coolify-mcp
npm install
npm run refresh
npm run dev

API覆盖

✅ 100% Coolify API覆盖 —— 应用程序、服务、数据库、项目、服务器、部署、私钥、系统管理

许可证

GLWTPL（祝你好运公共许可证）—— 详情见LICENSE文件。

此软件可能正常工作或不工作，没有第三种选择。祝您好运，一路平安。

MCP配置

方案1：使用npx（推荐 - 简单！）

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

方案2：直接执行node

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "node",
      "args": ["node_modules/@felixallistar/coolify-mcp/dist/index.js", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

方案3：全局安装

npm install -g @felixallistar/coolify-mcp

然后使用MCP服务器二进制文件：

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

CLI使用

对于CLI命令，只需向coolify-mcp命令添加参数：

# 使用npx（无需安装）
npx @felixallistar/coolify-mcp --help
npx @felixallistar/coolify-mcp apps list

# 或者全局安装以便更轻松地使用CLI
npm install -g @felixallistar/coolify-mcp
coolify-mcp --help
coolify-mcp apps list