Coolify MCP 服务器

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

示例提示

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

服务器管理

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

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

项目管理

# 项目操作
- 列出我的所有Coolify项目
- 创建一个名为“my-webapp”的新项目，并添加描述“我的Web应用程序”
- 显示项目 {uuid} 的详细信息
- 更新项目 {uuid} 更改其名称为“new-name”
- 删除项目 {uuid}

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

应用程序和服务管理

# 应用程序管理
- 列出所有应用程序
- 显示应用程序 {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。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

许可证

MIT

支持

支持方式：

1. 查看问题页面
2. 如有需要，请创建新问题
3. 加入Coolify社区