AI导哈

Coolify MCP 服务器

Coolify MCP Server是一个用于Coolify API集成的模型上下文协议服务器，支持多团队配置和27种工具，可直接从Claude Code或任何MCP兼容客户端管理应用程序、数据库、服务和服务器。

  • by Softtor
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Softtor/coolify-mcp-server

使用说明

冷却MCP服务器

MCP（模型上下文协议）服务器 冷却 API集成。直接从Claude Code或任何兼容MCP的客户端管理您的应用程序、数据库、服务、服务器和部署。

特性

  • 动态API密钥配置的多流支持
  • 涵盖所有主要Coolify操作的27个工具
  • 完全支持TypeScript
  • 与Claude Code和其他MCP客户端兼容

安装

使用npx（推荐）

无需安装。直接在MCP设置中配置：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@softtor/coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_KEY": "your-api-key"
      }
    }
  }
}

全球安装

npm install -g @softtor/coolify-mcp-server

然后在MCP设置中配置：

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp-server",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_KEY": "your-api-key"
      }
    }
  }
}

配置

环境变量

变量 必填 描述
COOLIFY_BASE_URL 是 您的Coolify实例URL（例如。， https://coolify.example.com)
COOLIFY_API_KEY 否* 默认API密钥
COOLIFY_DEFAULT_TEAM 否 默认团队名称（默认值： default)
COOLIFY_TEAM_<NAME>_API_KEY 否* 特定于团队的API密钥

*必须至少提供一个API密钥。

多团队配置

对于拥有多个Coolify团队的组织，配置特定于团队的API密钥：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@softtor/coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_DEFAULT_TEAM": "production",
        "COOLIFY_TEAM_PRODUCTION_API_KEY": "prod-api-key",
        "COOLIFY_TEAM_STAGING_API_KEY": "staging-api-key",
        "COOLIFY_TEAM_DEV_API_KEY": "dev-api-key"
      }
    }
  }
}

然后使用 team 任何工具中的参数：

coolify_list_applications { team: "staging" }

获取API密钥

  1. 登录您的Coolify实例
  2. 首选 设置 > API令牌
  3. 创建具有适当权限的新令牌
  4. 复制令牌并将其用作API密钥

重要提示：代币属于团队范围

Coolify API代币由团队确定范围。 每个令牌只提供对创建它的团队内资源的访问。这意味着：

  • 在“Infocell”团队中创建的令牌只能访问Infocell的应用程序、数据库和服务器
  • 要跨多个团队管理资源，每个团队都需要一个单独的令牌
  • 使用多团队配置时，请确保 COOLIFY_TEAM_<NAME>_API_KEY 对应于在该特定团队中创建的令牌

请参阅 Coolify API文档 有关令牌范围和权限的更多详细信息。

可用工具

应用程序（6个工具）

工具 说明
coolify_list_applications 列出所有应用程序
coolify_get_application 通过UUID获取应用程序详细信息
coolify_start_application 启动/部署应用程序
coolify_stop_application 停止正在运行的应用程序
coolify_restart_application 重新启动应用程序
coolify_get_application_logs 获取容器日志

数据库（6个工具）

工具 说明
coolify_list_databases 列出所有数据库
coolify_get_database 通过UUID获取数据库详细信息
coolify_start_database 启动数据库
coolify_stop_database 停止正在运行的数据库
coolify_restart_database 重新启动数据库
coolify_list_database_backups 列出数据库备份

服务（5个工具）

工具 说明
coolify_list_services 列出所有服务
coolify_get_service 通过UUID获取服务详细信息
coolify_start_service 启动服务
coolify_stop_service 停止正在运行的服务
coolify_restart_service 重新启动服务

服务器（4个工具）

工具 说明
coolify_list_servers 列出所有服务器
coolify_get_server 通过UUID获取服务器详细信息
coolify_get_server_resources 获取服务器上的所有资源
coolify_get_server_domains 获取服务器上映射的所有域

部署（2个工具）

工具 说明
coolify_deploy 按UUID或标签部署
coolify_list_deployments 列出部署历史记录

项目和团队（4个工具）

工具 说明
coolify_list_projects 列出所有项目
coolify_get_project 通过UUID获取项目详细信息
coolify_list_teams 列出所有可访问的团队
coolify_get_team 按ID获取团队详细信息

用法示例

列出所有应用程序

coolify_list_applications

部署应用程序

coolify_deploy { uuid: "app-uuid-here" }

部署兵力重建

coolify_deploy { uuid: "app-uuid-here", force: true }

使用标签部署所有应用程序

coolify_deploy { tag: "production" }

获取应用程序日志

coolify_get_application_logs { uuid: "app-uuid-here", since: 3600 }

使用特定的团队

coolify_list_applications { team: "staging" }

发展

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

# Install dependencies
npm install

# Build
npm run build

# Run locally
COOLIFY_API_KEY=your-key npm start

贡献

欢迎投稿！请随时提交拉取请求。

许可证

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

相关

相关 MCP