请立即使用该技能: https://github.com/FelixAllistar/coolify-manager
冷却MCP服务器
用于管理Coolify部署的模型上下文协议(MCP)服务器,提供可编程的MCP工具和全面的CLI命令。
快速开始
选项1:MCP集成(推荐)
MCP(模型控制协议)允许您直接从AI编辑器管理Coolify。
1.添加到MCP配置中
对于光标: 添加到 ~/.cursor/mcp.json 或 /.cursor/mcp.json:
{
"mcpServers": {
"coolify-mcp": {
"command": "npx",
"args": ["-y", "@felixallistar/coolify-mcp", "--server"],
"env": {
"COOLIFY_API_URL": "https://your-coolify-instance.com",
"COOLIFY_API_TOKEN": "your-coolify-api-token"
}
}
}
}对于VS代码: 添加到 /.vscode/mcp.json:
{
"servers": {
"coolify-mcp": {
"command": "npx",
"args": ["-y", "@felixallistar/coolify-mcp", "--server"],
"env": {
"COOLIFY_API_URL": "https://your-coolify-instance.com",
"COOLIFY_API_TOKEN": "your-coolify-api-token"
},
"type": "stdio"
}
}
}🔑 替换your-coolify-instance.com使用您的实际Coolify URL和your-coolify-api-token从Coolify设置>API使用您的API令牌。
2.(仅光标)启用冷却MCP
打开光标设置(Ctrl+Shift+J)➡ 点击MCP选项卡➡ 通过切换启用冷却mcp
3.开始管理Coolify
在您的AI聊天中,尝试以下命令:
List my Coolify applications
Create a new WordPress service called "my-blog"
Deploy my app with ID "app-123"
Show me all available database types选项2:CLI使用
安装
# Install globally for CLI usage
npm install -g @felixallistar/coolify-mcp
# Test the installation
coolify-mcp --help配置
创建一个 .env 项目目录中的文件:
# Required: Your Coolify instance URL (include port if needed)
COOLIFY_API_URL=https://your-coolify-instance.com
# Required: Your Coolify API token (generate in Coolify Settings > API)
COOLIFY_API_TOKEN=your-coolify-api-token常用命令
# Application management
coolify-mcp apps list
coolify-mcp apps create-public --name "my-app" --repository "https://github.com/user/repo" --project "project-id"
coolify-mcp apps start app-id
# Service management (70+ one-click services)
coolify-mcp services types
coolify-mcp services create --name "my-blog" --type "wordpress-with-mysql" --project "project-id"
# Database management (8 database types)
coolify-mcp databases create-postgresql --name "main-db" --project "project-id"
coolify-mcp databases create-redis --name "cache" --project "project-id"
# Project management
coolify-mcp projects list
coolify-mcp projects create --name "My Project"
# Test connectivity
coolify-mcp system health特性
🔄 应用程序 (21项操作)
通过6种部署类型、环境变量、日志和控制操作完成应用程序生命周期管理。
🔧 服务 (14项操作)
70+一键服务,包括WordPress、Ghost、MinIO等,具有完整的环境管理功能。
🗄️ 数据库 (13项操作)
8种数据库类型:PostgreSQL、MySQL、MariaDB、MongoDB、Redis、KeyDB、ClickHouse、Dragonfly。
📂 项目、服务器、部署
完整的基础设施管理,包括私钥、系统管理和部署监控。
MCP工具与CLI命令
此包提供了两种交互方法 完全特征奇偶校验:
- 🤖 MCP工具:用于AI代理和Cursor集成(推荐)
- 💻 CLI命令:用于直接终端使用
这两个界面提供相同的功能-根据您的工作流程进行选择。
发展
API自动更新
与Coolify最新的API保持同步:
npm run refresh # Download latest API spec and rebuild
npm run check-updates # Check for API changes手动开发
git clone https://github.com/FelixAllistar/coolify-mcp.git
cd coolify-mcp
npm install
npm run refresh
npm run devAPI覆盖范围
✅ 100%Coolify API覆盖范围 -应用程序、服务、数据库、项目、服务器、部署、私钥、系统管理
许可证
GLWTPL(祝您使用该公共许可证好运)-请参阅 许可证 文件以获取详细信息。
*这个软件可能只是工作或不工作,没有第三种选择。祝你好运,愿上帝保佑。*
MCP配置
选项1:使用npx(推荐-简单!)
{
"mcpServers": {
"coolify-mcp": {
"command": "npx",
"args": ["-y", "@felixallistar/coolify-mcp", "--server"],
"env": {
"COOLIFY_API_URL": "https://your-coolify-instance.com",
"COOLIFY_API_TOKEN": "your-coolify-api-token"
}
}
}
}选项2:直接节点执行
{
"mcpServers": {
"coolify-mcp": {
"command": "node",
"args": ["node_modules/@felixallistar/coolify-mcp/dist/index.js", "--server"],
"env": {
"COOLIFY_API_URL": "https://your-coolify-instance.com",
"COOLIFY_API_TOKEN": "your-coolify-api-token"
}
}
}
}选项3:全局安装
npm install -g @felixallistar/coolify-mcp然后使用MCP服务器二进制文件:
{
"mcpServers": {
"coolify-mcp": {
"command": "coolify-mcp",
"env": {
"COOLIFY_API_URL": "https://your-coolify-instance.com",
"COOLIFY_API_TOKEN": "your-coolify-api-token"
}
}
}
}CLI使用情况
对于CLI命令,只需将参数添加到 coolify-mcp 命令:
# Using npx (no installation needed)
npx @felixallistar/coolify-mcp --help
npx @felixallistar/coolify-mcp apps list
# Or install globally for easier CLI usage
npm install -g @felixallistar/coolify-mcp
coolify-mcp --help
coolify-mcp apps list