使用说明
冷却MCP服务器
用于Coolify API集成的安全模型上下文协议（MCP）服务器，专为Claude Code设计。
🔒 安全通知
这是一个 安全审计 在我们自己的控制下维护Coolify MCP服务器的实施，用于：
- 供应链安全
- 受控依赖关系管理
- 自定义安全增强功能
- 所有变更的审计跟踪
特性
- 应用程序管理：列出、部署、停止和重新启动Coolify应用程序
- 部署监控：检查部署状态和日志
- 网钩 管理：创建和管理特定于应用程序的Webhook
- 服务器信息：获取服务器详细信息和配置
- MCP协议：完全符合Claude Code集成的模型上下文协议
安装
npm install
配置
创建一个 .env 文件或设置环境变量：
COOLIFY_URL=http://your-coolify-instance:8000
COOLIFY_TOKEN_PATH=/path/to/coolify/token
PLATFORM_IP=your-platform-ip # Optional: defaults to localhost
用法
单独模式
npm start
发展模式
npm run dev
测试
npm test
Claude代码集成
添加到克劳德代码MCP配置：
claude mcp add coolify-mcp \
-e COOLIFY_URL=http://your-coolify-instance:8000 \
-e COOLIFY_TOKEN_PATH=/path/to/token \
-- node /path/to/coolify-mcp-server/index.js
可用的MCP工具
| 工具名称 | 描述 | 参数 |
|---|---|---|
coolify_list_applications |
列出所有应用程序 | 无 |
coolify_get_application |
获取应用程序详细信息 | uuid |
coolify_deploy_application |
部署应用程序 | uuid, forceRebuild （可选） |
coolify_get_deployment_status |
获取部署状态 | uuid |
coolify_list_deployments |
列出应用程序部署 | uuid |
coolify_stop_application |
停止应用程序 | uuid |
coolify_restart_application |
重新启动应用程序 | uuid |
coolify_get_application_logs |
获取应用程序日志 | uuid, lines （可选）， since （可选） |
coolify_create_webhook 创建 webhook applicationUuid, name, url, secret （可选） |
||
coolify_get_server_info |
获取服务器信息 | 无 |
coolify_list_servers |
列出所有服务器 | 无 |
安全功能
- 基于令牌的身份验证：使用Coolify API进行安全承载令牌身份验证
- 输入验证：在API调用之前验证的所有参数
- 错误处理：安全的错误响应，不会暴露敏感数据
- 无外部依赖关系：最小的安全依赖足迹
- 审计日志：用于安全监控的请求/响应日志记录
使用的API端点
GET /api/v1/applications-列出应用程序GET /api/v1/applications/{uuid}-获取应用程序详细信息POST /api/v1/applications/{uuid}/deploy-部署应用程序GET /api/v1/servers-获取服务器信息POST /api/v1/applications/{uuid}/webhooks- 创建网上挂钩
依赖项
- 轴：API请求的HTTP客户端
- dotenv：环境变量管理
- 节点：开发服务器（开发依赖关系）
安全审计
此代码库已针对以下内容进行了安全审计：
- ✅ 数据泄漏预防
- ✅ 外部连接验证
- ✅ 快速注射保护
- ✅ 依赖漏洞扫描
- ✅ 身份验证安全
看 SECURITY.md 进行详细的安全评估。
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
贡献
- 所有捐款都需要安全第一的方法
- 所有更改都必须通过安全审查
- 添加之前必须审核依赖关系
- 遵循现有的代码模式和文档
支持
对于问题或疑问：
- 在此存储库中创建GitHub问题
- 包括相关日志（敏感数据已编辑）
- 提供环境详细信息
