Coolify MCP Tools

冷却MCP工具

全面 模型上下文协议（MCP） 服务器 冷却 -开源、可自托管的Heroku/Netlify替代品。

此MCP服务器使像Claude这样的AI助手能够管理您的Coolify基础设施，包括服务器、项目、应用程序、数据库、服务等。

兼容性

适用于以下两种情况：

• 冷却云 - cloud.coolify.io
• Coolify自托管 -任何自托管的Coolify实例（v4.x）

特性

• 98工具 涵盖整个Coolify API
• 所有Coolify资源的完整CRUD操作
• 数据库备份管理
• GitHub应用程序集成
• 部署管理和监控
• 环境变量管理
• 适用于Coolify Cloud和自托管实例
• 通过npx轻松安装一个命令

安装

使用npx（推荐）

npx coolify-mcp-tools

全球安装

npm install -g coolify-mcp-tools
coolify-mcp

来源

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

配置

环境变量

基本URL示例：

• 冷却云： https://app.coolify.io
• 自托管： https://coolify.yourdomain.com （您的Coolify URL）

获取您的Coolify访问令牌

1. 登录您的Coolify实例（云端或自托管）
2. 首选 设置 > API
3. 启用API（如果尚未启用）
4. 点击 创建新令牌
5. 为其命名（例如，“MCP服务器”）
6. 复制生成的令牌

Claude桌面配置

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["coolify-mcp-tools"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude代码（CLI）配置

将此添加到您的Claude Code设置文件中：

macOS/Linux: ~/.claude/settings.json 视窗: %USERPROFILE%\.claude\settings.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["coolify-mcp-tools"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token-here"
      }
    }
  }
}

可用工具

服务器（8个工具）

• list_servers -列出所有Coolify服务器
• get_server -获取服务器详细信息
• create_server -创建新服务器
• update_server -更新服务器配置
• delete_server -删除服务器
• get_server_resources -获取服务器上运行的资源
• get_server_domains -获取服务器上配置的域
• validate_server -验证服务器连接

项目（9个工具）

• list_projects -列出所有项目
• get_project -获取项目详细信息
• create_project -创建新项目
• update_project -更新项目
• delete_project -删除项目
• get_project_environment -获取环境详细信息
• list_project_environments -列出所有环境
• create_project_environment -创建新环境
• delete_project_environment -删除环境

应用程序（21个工具）

• list_applications -列出所有应用程序
• get_application -获取应用程序详细信息
• create_public_application -从公共git仓库创建
• create_private_ghapp_application -从私有GitHub应用仓库创建
• create_private_deploykey_application -使用部署密钥从私有仓库创建
• create_dockerfile_application -从Dockerfile创建
• create_dockerimage_application -从Docker镜像创建
• create_dockercompose_application -从Docker Compose创建
• update_application -更新应用程序
• delete_application -删除应用程序
• start_application -启动应用程序
• stop_application -停止应用程序
• restart_application -重新启动应用程序
• deploy_application -部署应用程序
• get_application_logs -获取应用程序日志
• execute_application_command -在容器中执行命令
• list_application_envs -列出环境变量
• create_application_env -创建环境变量
• update_application_env -更新环境变量
• bulk_update_application_envs -批量更新环境变量
• delete_application_env -删除环境变量

数据库（21个工具）

• list_databases -列出所有数据库
• get_database -获取数据库详细信息
• update_database -更新数据库
• delete_database -删除数据库
• create_postgres_database -创建PostgreSQL数据库
• create_mysql_database -创建MySQL数据库
• create_mariadb_database -创建MariaDB数据库
• create_mongodb_database -创建MongoDB数据库
• create_redis_database -创建Redis数据库
• create_keydb_database -创建KeyDB数据库
• create_clickhouse_database -创建Clickhouse数据库
• create_dragonfly_database -创建Dragonfly数据库
• start_database -启动数据库
• stop_database -停止数据库
• restart_database -重新启动数据库
• list_database_backups -列出备份配置
• create_database_backup -创建备份配置
• update_database_backup -更新备份配置
• delete_database_backup -删除备份配置
• list_backup_executions -列出备份执行情况
• delete_backup_execution -删除备份执行

服务（16工具）

• list_services -列出所有一键服务
• get_service -获取服务详细信息
• create_service -创建一键式服务（WordPress、n8n等）
• update_service -更新服务
• delete_service -删除服务
• start_service -启动服务
• stop_service -停止服务
• restart_service -重新启动服务
• list_service_envs -列出环境变量
• create_service_env -创建环境变量
• update_service_env -更新环境变量
• bulk_update_service_envs -批量更新环境变量
• delete_service_env -删除环境变量

GitHub应用程序（6个工具）

• list_github_apps -列出GitHub应用程序集成
• create_github_app -创建GitHub应用程序集成
• update_github_app -更新GitHub应用程序
• delete_github_app -删除GitHub应用程序
• list_github_app_repositories -列出可访问的存储库
• list_github_app_branches -列出存储库分支

私钥（5个工具）

• list_private_keys -列出所有私钥
• get_private_key -获取私钥详细信息
• create_private_key -创建新的私钥
• update_private_key -更新私钥
• delete_private_key -删除私钥

团队（5个工具）

• list_teams -列出所有团队
• get_team -获取团队详细信息
• get_team_members -获取团队成员
• get_current_team -获取当前经过身份验证的团队
• get_current_team_members -获取当前团队成员

部署（5个工具）

• list_deployments -列出正在运行的部署
• get_deployment -获取部署详细信息
• get_deployments_by_application -获取应用程序的部署
• cancel_deployment -取消部署
• deploy -按标签或UUID部署

实用工具（5个工具）

• list_resources -列出所有资源
• get_version -获取Coolify版本
• healthcheck -检查API运行状况
• enable_api -启用Coolify API
• disable_api -禁用Coolify API

支持的一键式服务

这 create_service 该工具支持80多种一键服务，包括：

• 内容管理系统：WordPress、Ghost、Directus、Strapi
• 自动化：n8n，活性片
• 分析：Umami、Posthog、代谢酶
• 协作：Nextcloud、Penpot、Mattermost
• 发展：Gitea、代码服务器、Docker注册表
• 监控：正常运行时间Kuma、Grafana、Glances
• 还有更多。..

使用示例

配置后，您可以要求Claude：

• “列出我的所有Coolify服务器”
• “在我的生产项目中创建一个新的PostgreSQL数据库”
• “部署我的应用程序并显示日志”
• “使用MySQL建立一个新的WordPress网站”
• “显示所有正在运行的部署”
• “为我的数据库创建备份计划”

发展

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Lint
npm run lint

# Format code
npm run format

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

许可证

MIT许可证-请参阅 许可证 了解详情。

链接

• 冷却 -自托管平台
• Coolify API文档 -API官方文件
• 模型上下文协议 -MCP规范
• 克劳德桌面 -支持MCP的AI助手