AI导哈

Coolify MCP服务器

Coolify MCP服务器是一个用于Coolify API的模型上下文协议服务器，通过AI助手（如Claude）管理自托管的PaaS基础设施。

  • by ruashots
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Ruashots/coolify-mcp

使用说明

冷却MCP服务器

模型上下文协议（MCP）服务器 冷却 API通过Claude等人工智能助手管理您的自托管PaaS基础设施。

快速安装

curl -fsSL https://raw.githubusercontent.com/Ruashots/coolify-mcp/master/install.sh | bash

这将：

  • 将存储库克隆到 ~/.local/share/coolify-mcp
  • 安装依赖项并构建
  • 提示输入您的Coolify URL和API令牌
  • 自动配置Claude代码

其他命令：

# Reconfigure credentials
~/.local/share/coolify-mcp/install.sh --reconfigure

# Uninstall
~/.local/share/coolify-mcp/install.sh --uninstall

特性

70+工具 涵盖整个Coolify API：

  • 应用程序 -从Git仓库、Dockerfiles、Docker镜像或Docker Compose进行部署
  • 数据库 -PostgreSQL、MySQL、MariaDB、MongoDB、Redis、ClickHouse、DragonFly、KeyDB
  • 服务 -基于模板的服务或自定义Docker Compose堆栈
  • 服务器 -管理和验证您的基础架构
  • 项目与环境 -组织您的资源
  • 部署 -通过UUID、标签或PR预览进行部署
  • 环境变量 -具有批量操作的完整CRUD

先决条件

  • Node.js 18+
  • 正在运行的Coolify实例
  • Coolify API代币
  • jq （用于自动克劳德代码配置）

手动安装

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

# Install dependencies
npm install

# Build
npm run build

获取Coolify API代币

  1. 登录您的Coolify仪表板
  2. 首选 密钥和令牌 > API令牌
  3. 点击 创建新令牌
  4. 复制令牌（仅显示一次）

用法

克劳德代码CLI

使用添加MCP服务器 claude CLI：

claude mcp add coolify \
  --transport stdio \
  -e COOLIFY_API_TOKEN="your-api-token" \
  -e COOLIFY_BASE_URL="http://your-coolify-instance:8000" \
  -- node /path/to/coolify-mcp/dist/index.js

范围选项：

标志 描述
（默认） 本地到当前目录
--scope user 适用于您的所有项目
--scope project 通过与团队共享 .mcp.json

管理服务器：

# List configured servers
claude mcp list

# Check server details
claude mcp get coolify

# Remove server
claude mcp remove coolify

克劳德桌面版

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_API_TOKEN": "your-api-token",
        "COOLIFY_BASE_URL": "http://your-coolify-instance:8000"
      }
    }
  }
}

手动/环境变量

export COOLIFY_API_TOKEN="your-api-token"
export COOLIFY_BASE_URL="http://your-coolify-instance:8000"
node /path/to/coolify-mcp/dist/index.js

可用工具

系统

工具 说明
coolify_health 检查实例运行状况
coolify_version 获取Coolify版本
coolify_enable_api 启用API

团队

工具 说明
coolify_list_teams 列出所有团队
coolify_get_current_team 获取当前团队
coolify_get_team_members 获取团队成员

项目

工具 说明
coolify_list_projects 列出所有项目
coolify_get_project 按UUID获取项目
coolify_create_project 创建新项目
coolify_update_project 更新项目
coolify_delete_project 删除项目

环境

工具 说明
coolify_get_project_environment 获取环境
coolify_create_environment 创造环境
coolify_delete_environment 删除环境

服务器

工具 说明
coolify_list_servers 列出所有服务器
coolify_get_server 通过UUID获取服务器
coolify_create_server 添加新服务器
coolify_update_server 更新服务器
coolify_delete_server 删除服务器
coolify_validate_server 验证连接
coolify_get_server_resources 获取已部署的资源
coolify_get_server_domains 获取域映射

GitHub应用程序

工具 说明
coolify_list_github_apps 列出所有GitHub应用程序（获取私有存储库的UUID和ID）
coolify_list_github_app_repositories 列出GitHub应用程序可访问的存储库（使用数字 id)

私钥

工具 说明
coolify_list_private_keys 列出SSH密钥
coolify_get_private_key 通过UUID获取密钥
coolify_create_private_key 创建SSH密钥
coolify_update_private_key 更新密钥
coolify_delete_private_key 删除密钥

应用程序

工具 说明
coolify_list_applications 列出所有应用程序
coolify_get_application 通过UUID获取应用程序
coolify_create_application_public 从公共Git仓库创建
coolify_create_application_private_github 从GitHub创建（应用程序认证）
coolify_create_application_private_deploy_key 从私有仓库创建（SSH）
coolify_create_application_dockerfile 从Dockerfile创建
coolify_create_application_docker_image 从Docker镜像创建
coolify_create_application_docker_compose 从Docker Compose创建
coolify_update_application 更新应用程序
coolify_delete_application 删除应用程序
coolify_start_application 启动/部署应用程序
coolify_stop_application 停止应用程序
coolify_restart_application 重新启动应用程序
coolify_get_application_logs 获取日志

应用程序环境变量

工具 说明
coolify_list_application_envs 列出环境变量
coolify_create_application_env 创建环境变量
coolify_update_application_env 更新环境变量
coolify_delete_application_env 删除环境变量
coolify_bulk_update_application_envs 批量更新

数据库

工具 说明
coolify_list_databases 列出所有数据库
coolify_get_database 通过UUID获取数据库
coolify_create_database_postgresql 创建PostgreSQL
coolify_create_database_mysql 创建MySQL
coolify_create_database_mariadb 创建MariaDB
coolify_create_database_mongodb 创建MongoDB
coolify_create_database_redis 创建Redis
coolify_create_database_clickhouse 创建ClickHouse
coolify_create_database_dragonfly 创建DragonFly
coolify_create_database_keydb 创建KeyDB
coolify_update_database 更新数据库
coolify_delete_database 删除数据库
coolify_start_database 启动数据库
coolify_stop_database 停止数据库
coolify_restart_database 重新启动数据库

服务

工具 说明
coolify_list_services 列出所有服务
coolify_get_service 通过UUID获取服务
coolify_create_service 创建服务
coolify_update_service 更新服务
coolify_delete_service 删除服务
coolify_start_service 启动服务
coolify_stop_service 停止服务
coolify_restart_service 重新启动服务

服务环境变量

工具 说明
coolify_list_service_envs 列出环境变量
coolify_create_service_env 创建环境变量
coolify_update_service_env 更新环境变量
coolify_delete_service_env 删除环境变量

部署

工具 说明
coolify_deploy 按UUID或标签部署
coolify_list_deployments 列出部署
coolify_get_deployment 获取部署详细信息

资源

工具 说明
coolify_list_resources 列出所有资源

示例提示

配置后，使用自然语言：

"List all my applications"

"Create a PostgreSQL database called 'myapp-db' in the production environment"

"Deploy application abc-123 with a force rebuild"

"Show me the last 100 lines of logs for my-api"

"Add DATABASE_URL environment variable to my-app"

"Stop all services in the staging project"

"What servers do I have and what's running on them?"

发展

npm install      # Install dependencies
npm run dev      # Run in development mode
npm run build    # Build for production
npm run watch    # Watch mode

安全

  • 保持API令牌的安全，永远不要将其提交给版本控制
  • 使用环境变量进行敏感配置
  • 创建具有最低所需权限的令牌
  • 这 can_read_sensitive 权限控制对密码和API密钥的访问

许可证

麻省理工学院

链接

相关 MCP