Coolify MCP 服务器

一个用于 Coolify 的模型上下文协议 (MCP) 服务器实现，使 AI 助手能够通过自然语言与您的 Coolify 实例交互。

示例提示

以下是一些您可以与 MCP 兼容的 AI 助手一起使用的示例提示，以与您的 Coolify 实例交互：

服务器管理

# 列出和检查服务器
- 显示我实例中的所有 Coolify 服务器
- 服务器 {uuid} 的状态是什么？
- 显示服务器 {uuid} 上运行的资源
- 服务器 {uuid} 配置了哪些域名？
- 您能验证与服务器 {uuid} 的连接吗？

# 资源监控
- 服务器 {uuid} 使用了多少 CPU 和内存？
- 列出服务器 {uuid} 上运行的所有资源
- 显示所有服务器的当前状态

项目管理

# 项目操作
- 列出我所有的 Coolify 项目
- 创建一个名为 "my-webapp" 的新项目，描述为 "My web application"
- 显示项目 {uuid} 的详细信息
- 更新项目 {uuid} 以将其名称更改为 "new-name"
- 删除项目 {uuid}

# 环境管理
- 显示项目 {uuid} 中的环境
- 获取项目 {uuid} 中生产环境的详细信息
- 项目 {uuid} 的 staging 环境中设置了哪些变量？

应用程序和服务管理

# 应用程序管理
- 列出所有应用程序
- 显示应用程序 {uuid} 的详细信息
- 创建一个名为 "my-nodejs-app" 的新应用程序
- 删除应用程序 {uuid}

# 服务操作
- 显示所有正在运行的服务
- 创建一个新的 WordPress 服务：
  - 名称：my-blog
  - 项目 UUID：{project_uuid}
  - 服务器 UUID：{server_uuid}
  - 类型：wordpress-with-mysql
- 服务 {uuid} 的状态是什么？
- 删除服务 {uuid} 并清理其资源

数据库管理

# 数据库操作
- 列出所有数据库
- 显示数据库 {uuid} 的配置
- 更新数据库 {uuid}：
  - 将内存限制增加到 1GB
  - 将公共端口更改为 5432
  - 更新密码
- 删除数据库 {uuid} 并清理卷

# 数据库类型
- 创建一个 PostgreSQL 数据库
- 设置一个 Redis 实例
- 配置一个 MongoDB 数据库
- 初始化一个 MySQL 数据库

部署管理

# 部署操作
- 显示所有活动部署
- 部署 {uuid} 的状态是什么？
- 部署应用程序 {uuid}
- 强制重建并部署应用程序 {uuid}
- 列出应用程序 {uuid} 的最近部署

安装

前提条件

• Node.js >= 18
• 一个正在运行的 Coolify 实例
• Coolify API 访问令牌

在 AI 工具中设置

Claude Desktop

"coolify": {
    "command": "npx",
    "args": [
        "-y", "@masonator/coolify-mcp"
    ],
    "env": {
        "COOLIFY_ACCESS_TOKEN": "0|your-secret-token",
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com"
    }
}

Cursor

env COOLIFY_ACCESS_TOKEN:0|your-secret-token COOLIFY_BASE_URL:https://your-coolify-instance.com npx -y @stumason/coolify-mcp

开发

本地设置

# 克隆仓库
git clone https://github.com/stumason/coolify-mcp.git
cd coolify-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

环境变量

# 必需
COOLIFY_ACCESS_TOKEN=your_access_token_here

# 可选 (默认为 http://localhost:3000)
COOLIFY_BASE_URL=https://your.coolify.instance

API 参考

资源类型

应用程序

interface Application {
  uuid: string;
  name: string;
  // 基于您的 Coolify 实例的其他属性
}

服务

interface Service {
  id: number;
  uuid: string;
  name: string;
  type: ServiceType; // 各种类型，如 'wordpress', 'mysql' 等。
  status: 'running' | 'stopped' | 'error';
  project_uuid: string;
  environment_uuid: string;
  server_uuid: string;
  domains?: string[];
}

数据库

interface Database {
  id: number;
  uuid: string;
  name: string;
  type: 'postgresql' | 'mysql' | 'mongodb' | 'redis' | /* 其他类型 */;
  status: 'running' | 'stopped' | 'error';
  is_public: boolean;
  public_port?: number;
  // 基于数据库类型的其他配置
}

部署

interface Deployment {
  id: number;
  uuid: string;
  application_uuid: string;
  status: string;
  created_at: string;
  updated_at: string;
}

贡献

欢迎贡献！请随时提交 Pull Request。对于重大更改，请先打开一个 issue 讨论您想要更改的内容。

许可证

MIT

支持

如需支持，请：

1. 查看 issues 页面
2. 如果需要，创建一个新的 issue
3. 加入 Coolify 社区