金大哥 - coolify-mcp MCP 详情

article

README

🚀 Coolify MCP 服务器

Coolify MCP 服务器是为 Coolify 实现的 Model Context Protocol (MCP) 服务器，它能让 AI 助手通过自然语言与您的 Coolify 实例进行交互，极大提升了操作的便捷性和效率。

🚀 快速开始

Coolify MCP 服务器允许您借助自然语言与 Coolify 实例进行交互。以下是一些示例提示，可用于与 MCP 兼容的 AI 助手进行交互。

✨ 主要特性

多方面管理：支持对 Coolify 的服务器、项目、应用程序、服务、数据库和部署等进行全面管理。
自然语言交互：通过自然语言提示即可完成各种操作，无需复杂的命令。

📦 安装指南

先决条件

安装 Node.js 和 npm。
确保安装了最新版本的 Coolify CLI。
准备好 API 密钥和访问令牌。

在不同工具中的设置

在 ChatGPT 中的设置

将环境变量添加到配置中：

export COOLIFY_ACCESS_TOKEN=your_token
export COOLIFY_BASE_URL=https://api.your-coolify-instance.com

运行安装命令：
```
npm install coolify-mcp-server
```

在其他工具中的设置

请参考具体工具的文档进行相应配置。

💻 使用示例

服务器管理

# 列出和检查服务器
- 显示我实例中的所有 Coolify 服务器
- {uuid} 这台服务器的状态如何？
- 展示 {uuid} 服务器上运行的资源
- {uuid} 服务器配置了哪些域名？
- 能否验证对 {uuid} 服务器的连接？

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

项目管理

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

# 环境管理
- 列出项目 {uuid} 中的环境
- 查看项目 {uuid} 的生产环境详情
- 展示项目 {uuid} 竞态环境中设置的变量

应用程序和服务管理

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

# 服务管理
- 列出 {uuid} 应用程序的所有服务
- 显示 {uuid} 服务的当前状态
- 更新 {uuid} 服务的配置

数据库管理

# 数据库操作
- 创建一个新的数据库实例
- 删除指定的数据库实例
- 展示所有可用数据库的列表
- 更新数据库的配置参数

部署管理

# 部署操作
- 列出所有部署记录
- 查看 {uuid} 部署的状态和详细信息
- 撤销一个已有的部署

📚 详细文档

开发信息

本地设置

克隆仓库：

git clone https://github.com/your-username/coolify-mcp.git
cd coolify-mcp

安装依赖：
```
npm install
```
启动开发服务器：
```
npm run dev
```

环境变量

# 示例环境变量配置
COOLIFY_ENV=development
COOLIFY_API_KEY=your_api_key_here

API 参考

资源类型定义

应用程序接口

interface Application {
  id: number;
  uuid: string;
  name: string;
  description?: string;
}

服务接口

interface Service {
  id: number;
  uuid: string;
  application_uuid: string;
  name: string;
  status: 'running' | 'stopped';
  configuration: Record<string, any>;
}

数据库接口

interface Database {
  id: number;
  uuid: string;
  name: string;
  type: 'mysql' | 'postgres' | 'sqlite';
  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 许可证。

🛠️ 支持

如需支持，请按照以下步骤操作：

检查问题页面。
如果需要，创建新问题。
加入 Coolify 社区。

coolify-mcp