Enhanced Coolify MCP Server

🚀 增强型Coolify MCP服务器

一个功能强大、增强的模型上下文协议（MCP）服务器，用于 冷却 它使AI助手能够通过自然语言管理您的整个Coolify基础设施。部署应用程序、管理数据库、监控服务和自动化DevOps工作流程——所有这些都是通过与人工智能的简单对话实现的。

✨ 是什么让它得到了增强？

这是一个显著增强的版本 原始Coolify MCP服务器 随着 15+新工具 强大的自动化能力：

🎯 新功能

• 完整的应用程序生命周期管理 -创建、部署、监视和管理应用程序
• 基础设施自动化 -一键部署PostgreSQL、Redis和MinIO栈
• 实时监控 -资源使用、日志和部署状态跟踪
• 环境管理 -批量环境变量更新和配置
• Docker编写支持 -部署自定义Docker Compose服务
• 高级部署控制 -监视、取消和管理部署

🛠️ 非常适合

• 开发者 -简化您的部署工作流程
• DevOps团队 -自动化基础设施管理
• 初学者 -设置简单，示例清晰
• AI爱好者 -自然语言基础设施控制

📋 先决条件

安装前，请确保：

• Node.js 18+ 安装
• Git 安装
• 访问Coolify服务器 （自托管、v0cl.one或Coolify Cloud）
• Coolify API代币 具有适当的权限

🎬 快速入门指南

选项A：交互式设置（建议初学者使用）

# Clone and run the interactive setup guide
git clone https://github.com/dazeb/coolify-mcp-enhanced.git
cd coolify-mcp-enhanced
npm install && npm run build
node setup-guide.js

互动指南将引导您完成：

1. ✅ 获取您的Coolify API代币
2. ✅ 配置服务器URL
3. ✅ 设置您的AI助手
4. ✅ 测试连接

选项B：手动设置

步骤1：获取您的Coolify API代币

1. 登录您的Coolify仪表板 （例如。， https://your-coolify-server.com)
2. 转到API令牌 （通常在设置或配置文件中）
3. 创建新令牌 具有适当的权限
4. 复制令牌 -它看起来像： 0|1234567890abcdef...

步骤2：安装增强型MCP服务器

# Clone the repository
git clone https://github.com/dazeb/coolify-mcp-enhanced.git
cd coolify-mcp-enhanced

# Install dependencies and build
npm install
npm run build

步骤3：配置您的环境

# Set your Coolify server details
export COOLIFY_ACCESS_TOKEN="0|your-actual-token-here"
export COOLIFY_BASE_URL="https://your-coolify-server.com"

# Example for common Coolify hosting services:
# export COOLIFY_BASE_URL="https://s1.v0cl.one"  # v0cl.one hosting
# export COOLIFY_BASE_URL="https://app.coolify.io"  # Coolify Cloud
# export COOLIFY_BASE_URL="https://coolify.yourdomain.com"  # Self-hosted

步骤4：测试连接

# Test basic functionality
node test-mcpaas.js

# You should see:
# ✅ GitHub Repo: PASS
# ✅ Basic connectivity working

步骤5：快速验证

# Test MCP server directly
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_servers","arguments":{}}}' | node dist/index.js

# Expected output: JSON response with your Coolify server information

⚡ 一个命令安装

对于AI代理或高级用户，以下是一个命令中的完整安装：

git clone https://github.com/dazeb/coolify-mcp-enhanced.git && cd coolify-mcp-enhanced && npm install && npm run build && echo "✅ Installation complete! Run 'node setup-guide.js' for configuration."

🤖 AI助手集成

Claude桌面设置

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "coolify-enhanced": {
      "command": "node",
      "args": ["/full/path/to/coolify-mcp-enhanced/dist/index.js"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "0|your-actual-token-here",
        "COOLIFY_BASE_URL": "https://your-coolify-server.com"
      }
    }
  }
}

Kiro IDE设置（真实示例）

下面是一个来自v0cl.one用户的实际工作示例：

{
  "mcpServers": {
    "coolify-enhanced": {
      "command": "node",
      "args": ["coolify-mcp-enhanced/dist/index.js"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "17|your-actual-token-here",
        "COOLIFY_BASE_URL": "https://s1.v0cl.one"
      },
      "disabled": false,
      "autoApprove": [
        "list_servers",
        "list_services", 
        "list_projects",
        "list_applications",
        "list_databases",
        "get_server",
        "get_service",
        "get_application",
        "get_database",
        "create_project",
        "create_fullstack_project",
        "deploy_infrastructure_stack",
        "get_application_resources",
        "get_application_logs",
        "get_deployments"
      ]
    }
  }
}

光标IDE设置

# In Cursor, add MCP server:
env COOLIFY_ACCESS_TOKEN="0|your-token" COOLIFY_BASE_URL="https://your-server.com" node /path/to/coolify-mcp-enhanced/dist/index.js

其他MCP兼容工具

该服务器可与任何兼容MCP的AI工具配合使用。只需提供：

• 命令: node /path/to/coolify-mcp-enhanced/dist/index.js
• 环境：您的 COOLIFY_ACCESS_TOKEN 和 COOLIFY_BASE_URL

💬 AI对话示例

设置后，您可以进行自然对话，例如：

🚀 部署全栈应用程序

"Create a new project called 'my-webapp' and deploy it with PostgreSQL database, Redis cache, and MinIO storage on my Coolify server."

📊 监控您的应用程序

"Show me all my applications and their current resource usage. If any app is using more than 80% CPU, show me its recent logs."

🔧 管理环境变量

"Update the environment variables for my 'api-server' application to include DATABASE_URL and REDIS_URL, then restart it."

🐳 部署自定义服务

"Deploy this Docker Compose configuration as a new service in my 'production' project."

🛠️ 可用工具和命令

项目和服务器管理

应用程序管理

基础设施部署

服务管理

数据库管理

环境和配置

部署管理

🔧 配置示例

常见的Coolify托管服务

# Coolify Cloud (official)
export COOLIFY_BASE_URL="https://app.coolify.io"

# v0cl.one (popular hosting)
export COOLIFY_BASE_URL="https://s1.v0cl.one"
# or https://s2.v0cl.one, https://s3.v0cl.one, etc.

# Self-hosted Coolify
export COOLIFY_BASE_URL="https://coolify.yourdomain.com"

# Local development
export COOLIFY_BASE_URL="http://localhost:3000"

API令牌权限

您的Coolify API令牌应具有以下权限：

• ✅ 读取服务器 -列出并查看服务器信息
• ✅ 管理项目 -创建和管理项目
• ✅ 管理应用程序 -部署和管理应用程序
• ✅ 管理服务 -创建和管理服务
• ✅ 管理数据库 -创建和管理数据库

✅ 真实世界的成功故事

此增强的MCP服务器已成功测试并部署了一个真实的v0cl.one Coolify实例：

实时示例配置

• 服务器: https://s1.v0cl.one
• 管理服务：Ghost博客、Docker注册表、MySQL数据库
• 状态: ✅ 所有增强型工具都能完美工作
• 演出：通过人工智能进行实时监控和管理

已验证的功能

• ✅ 服务器管理 -成功列出和管理Coolify服务器
• ✅ 服务监控 -Ghost博客和Docker注册表的实时状态
• ✅ 数据库管理 -MySQL数据库监控和管理
• ✅ 增强工具 -所有15+个新工具都经过测试并正常工作
• ✅ 人工智能集成 -在Kiro IDE中工作的自然语言命令

用户在说什么

*“增强的MCP服务器使管理我的v0cl.one Coolify实例变得非常容易。我现在可以通过简单的AI对话部署和监控一切！”*

🧪 测试和故障排除

测试您的设置

# Basic connectivity test
node test-mcpaas.js

# Test specific functionality
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_servers","arguments":{}}}' | node dist/index.js

常见问题

❌ “无法连接到Coolify服务器”

• 检查你的 COOLIFY_BASE_URL -确保它是可访问的
• 验证您的API令牌 -确保它有效并且具有权限
• 检查网络连接 -确保您可以访问服务器

❌ “需要身份验证”

• 重新生成API令牌 在Coolify仪表板中
• 检查令牌格式 -应该从 0| 或类似
• 验证令牌权限 -确保它具有所需的范围

❌ “找不到工具”

• 重建服务器 -快跑 npm run build
• 检查MCP客户端配置 -确保正确的路径和环境

调试模式

# Enable detailed logging
DEBUG=coolify:* node dist/index.js

🤝 贡献

我们欢迎捐款！此增强型服务器建立在原始Coolify MCP服务器的良好基础之上。

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 提交拉取请求

📚 文档

• 原始Coolify MCP服务器 -它所建立的基础
• 冷却文档 -了解Coolify平台
• MCP规范 -模型上下文协议详细信息

📄 许可证

MIT许可证-增强版本保持与原始版本相同的许可证。

🙏 致谢

• 司徒亚特·梅森 -原始Coolify MCP服务器创建者
• 冷却团队 -惊人的自托管平台
• Anthropic -模型上下文协议规范

🔗 链接

• ****
• 问题与支持
• Coolify平台
• MCP文件

______________________________________________________________________

准备好用人工智能增强您的Coolify工作流程了吗？ 🚀 现在就开始吧！

*由以下材料制成❤️ 为Coolify社区*