STARWARCLOUD STARWAR.AI
返回市场
冷却器-mcp增强版

冷却器-mcp增强版

作者：dazeb12 星标更新：2025-08-23
安装使用来源：spider==github.com

项目介绍

🚀 增强版 Coolify MCP 服务器

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

✨ 为什么是增强版？

这是对 原始 Coolify MCP 服务器 的显著增强版本，具有15+ 新工具和强大的自动化功能：

🎯 新功能

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

🛠️ 适合人群

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

📋 先决条件

在安装之前，请确保您拥有以下内容：

  • 安装了 Node.js 18+
  • 安装了 Git
  • 访问到一个 Coolify 服务器（自托管、v0cl.one 或 Coolify Cloud）
  • 拥有适当权限的 Coolify API 令牌

🎬 快速入门指南

选项 A：交互式设置（推荐给初学者）

# 克隆并运行交互式设置指南
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：手动设置

第一步：获取您的 Coolify API 令牌

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

第二步：安装增强版 MCP 服务器

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

# 安装依赖项并构建
npm install
npm run build

第三步：配置您的环境

# 设置您的 Coolify 服务器详细信息
export COOLIFY_ACCESS_TOKEN="0|your-actual-token-here"
export COOLIFY_BASE_URL="https://your-coolify-server.com"

# 示例常见 Coolify 托管服务：
# export COOLIFY_BASE_URL="https://s1.v0cl.one"  # v0cl.one 托管
# export COOLIFY_BASE_URL="https://app.coolify.io"  # Coolify Cloud
# export COOLIFY_BASE_URL="https://coolify.yourdomain.com"  # 自托管

第四步：测试连接

# 测试基本功能
node test-mcpaas.js

# 您应该看到：
# ✅ GitHub Repo: PASS
# ✅ 基本连接正常

第五步：快速验证

# 直接测试 MCP 服务器
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_servers","arguments":{}}}' | node dist/index.js

# 预期输出：包含您的 Coolify 服务器信息的 JSON 响应

⚡ 单命令安装

对于 AI 代理或高级用户，这里是完整的单命令安装：

git clone https://github.com/dazeb/coolify-mcp-enhanced.git && cd coolify-mcp-enhanced && npm install && npm run build && echo "✅ 安装完成！运行 'node setup-guide.js' 进行配置。"

🤖 AI 助手集成

Claude Desktop 设置

在您的 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"
      ]
    }
  }
}

Cursor IDE 设置

# 在 Cursor 中添加 MCP 服务器：
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 对话

一旦设置完成，您可以进行如下自然对话：

🚀 部署全栈应用

"创建一个名为 'my-webapp' 的新项目，并在我的 Coolify 服务器上部署带有 PostgreSQL 数据库、Redis 缓存和 MinIO 存储的新项目。"

📊 监控您的应用

"显示我所有的应用及其当前资源使用情况。如果任何应用的 CPU 使用率超过 80%，显示其最近的日志。"

🔧 管理环境变量

"更新我的 'api-server' 应用的环境变量以包括 DATABASE_URL 和 REDIS_URL，然后重新启动它。"

🐳 部署自定义服务

"将此 Docker Compose 配置作为新服务部署在我的 'production' 项目中。"

🛠️ 可用工具及命令

项目及服务器管理

工具描述示例用途
list_servers列出所有 Coolify 服务器"显示我的所有服务器"
list_projects列出所有项目"我有哪些项目？"
create_project创建新项目"创建一个名为 'blog' 的项目"

应用管理

工具描述示例用途
list_applications列出所有应用"显示我的所有应用"
create_application部署新应用"将我的 GitHub 仓库部署为应用"
get_application_logs查看应用日志"显示我的 API 服务器的日志"
get_application_resources监控资源使用情况"我的应用使用了多少 CPU？"

基础设施部署

工具描述示例用途
create_fullstack_project创建带有常见服务的项目"设置一个全栈项目"
deploy_infrastructure_stack部署 PostgreSQL、Redis、MinIO"向我的项目添加数据库和缓存"

服务管理

工具描述示例用途
list_services列出所有服务"正在运行哪些服务？"
create_service创建新服务"添加一个 WordPress 服务"
create_docker_compose_service部署 Docker Compose"部署这个 compose 文件"

数据库管理

工具描述示例用途
list_databases列出所有数据库"显示我的数据库"
create_database创建新数据库"创建一个 PostgreSQL 数据库"
update_database更新数据库设置"更改数据库内存限制"

环境及配置

工具描述示例用途
get_application_environment_variables获取环境变量"显示环境变量"
update_application_environment_variables更新环境变量"更新 API 密钥"

部署管理

工具描述示例用途
get_deployments列出部署"显示部署历史"
cancel_deployment取消部署"停止失败的部署"
deploy_application部署应用"部署我的最新更改"

🔧 配置示例

常见 Coolify 托管服务

# Coolify Cloud（官方）
export COOLIFY_BASE_URL="https://app.coolify.io"

# v0cl.one（流行托管）
export COOLIFY_BASE_URL="https://s1.v0cl.one"
# 或 https://s2.v0cl.one, https://s3.v0cl.one 等

# 自托管 Coolify
export COOLIFY_BASE_URL="https://coolify.yourdomain.com"

# 本地开发
export COOLIFY_BASE_URL="http://localhost:3000"

API 令牌权限

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

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

✅ 实际成功案例

这个增强版 MCP 服务器已经在真实的 v0cl.one Coolify 实例中成功测试和部署：

实时示例配置

  • 服务器：https://s1.v0cl.one
  • 管理的服务：Ghost 博客、Docker 注册表、MySQL 数据库
  • 状态：✅ 所有增强工具完美工作
  • 性能：通过 AI 实现实时监控和管理

验证的功能

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

用户反馈

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

🧪 测试与故障排除

测试您的设置

# 基本连接性测试
node test-mcpaas.js

# 测试特定功能
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_servers","arguments":{}}}' | node dist/index.js

常见问题

❌ "无法连接到 Coolify 服务器"

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

❌ "需要身份验证"

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

❌ "未找到工具"

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

调试模式

# 启用详细日志
DEBUG=coolify:* node dist/index.js

🤝 贡献

我们欢迎贡献！这个增强版服务器建立在原始 Coolify MCP 服务器的优秀基础上。

  1. 分叉仓库
  2. 创建功能分支
  3. 为新功能添加测试
  4. 提交拉取请求

📚 文档

📄 许可证

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

🙏 致谢

🔗 链接

准备好用 AI 加速您的 Coolify 工作流程了吗？ 🚀 立即开始！

为 Coolify 社区制作 ❤️