Coolify MCP Server

基本能力

产品定位

Coolify MCP Server 是一个为 Coolify 平台设计的 MCP 服务实现，旨在通过自然语言交互简化 Coolify 实例的管理和操作。

核心功能

1. 服务器管理：列出和检查服务器状态、资源使用情况、域名配置等。
2. 项目管理：创建、更新、删除项目，管理项目环境及其变量。
3. 应用和服务管理：列出、创建、删除应用和服务，检查服务状态。
4. 数据库管理：支持多种数据库类型（如 PostgreSQL、MySQL、MongoDB、Redis）的创建、配置和删除。
5. 部署管理：查看部署状态，触发应用部署或强制重建。

适用场景

1. 开发团队：通过自然语言快速管理开发环境和资源。
2. DevOps 工程师：简化服务器和应用部署的监控与管理。
3. 数据库管理员：快速操作和配置多种类型的数据库。
4. AI 助手集成：通过自然语言指令与 Coolify 实例交互，提升操作效率。

工具列表

1. Claude Desktop：通过 JSON 配置集成 Coolify MCP Server。
2. Cursor：通过命令行工具集成 Coolify MCP Server。

常见问题解答

1. 如何获取 Coolify API 访问令牌？：需要在 Coolify 实例中生成并配置。
2. 如何调试本地开发环境？：通过 npm test 运行测试。
3. 如何贡献代码？：提交 Pull Request 或创建 Issue 讨论重大变更。

使用教程

使用依赖

1. Node.js >= 18：确保已安装 Node.js 18 或更高版本。
2. Coolify 实例：需要一个运行的 Coolify 实例。
3. Coolify API 访问令牌：获取并配置访问令牌。

安装教程

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

调试方式

1. 本地开发环境设置

git clone https://github.com/stumason/coolify-mcp.git
cd coolify-mcp
npm install
npm run build
npm test

1. 环境变量配置

COOLIFY_ACCESS_TOKEN=your_access_token_here
COOLIFY_BASE_URL=https://your.coolify.instance

许可证

该项目遵循 MIT 开源许可条款。