
Coolify 的 MCP 服务器——42 个优化工具,通过 AI 助手管理自托管的 PaaS
概览
通过自然语言管理Coolify——42个令牌优化的MCP工具,用于部署、调试和运行Claude、Cursor或任何MCP客户端的自托管PaaS。 📖 ——安装指南、工具参考、架构、安全模型、v3路线图。 你需要一个运行中的 Coolify v4 实例和一个 API 令牌(Coolify → 设置→ API)。 下载 coolify-mcp.mcpb 并拖入 。系统会提示你输入 Coolify URL 和令牌——无需安装 Node,也无需 JSON 编辑。 在Cloudflare Access或认证代理后面?添加--header “Key: Value”(可重复使用)。光标、多个Coolify实例和代理设置在安装指南中有介绍。 完整参考资料,包括参数和示例:工具文档。 - — 合并的动作参数工具将工具列表保持在~6,600个token,而不是~43,000个(减少85%),这样服务器就不会在你还没提任何问题前就吃掉你的上下文窗口。
概述(AI 翻译)
通过Claude、光标或任何MCP客户端管理Coolify:46个工具,用于部署、调试和运行你的自托管PaaS,用通俗易懂的语言表达。破坏性操作首先要找真人;秘密保持隐藏。
📖 coolify-mcp.stumason.dev ·工具参考 ·提示与资源 ·远程/HTTP模式 ·舰队 ·医生 ·安全与保障 ·更新日志
安装
你需要一个运行中的 Coolify v4 实例和一个 API 令牌(Coolify → Keys & Tokens → API 令牌)。选择三种运行服务器的方式之一。
Claude Desktop,一键操作。 下载coolify-mcp.mcpb并拖入**设置→扩展*。系统提示你输入Coolify的URL和令牌。无需安装Node,无需JSON编辑。
本地,在任何MCP客户端中。 Claude代码:
Codex CLI 与 codex mcp add 和 --env 是相同的。对于光标、Claude Desktop 或任何需要 JSON 配置的软件:
远程,作为Coolify内部的容器。 将服务器部署到Coolify管理的旁边,并 claude.ai、Claude Desktop或Claude Code连接到https://your-domain/mcp。你的Coolify令牌保持服务器端;客户端通过OAuth 2.1进行认证。在docs/http-mode.md中五分钟设置即可完成。
那就跑吧,医生
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Coolify MCP Server
Manage Coolify from Claude, Cursor, or any MCP client: 46 tools for deploying, debugging, and operating your self-hosted PaaS in plain English. Destructive operations ask a human first; secrets stay masked.
📖 coolify-mcp.stumason.dev · Tool reference · Prompts and resources · Remote / HTTP mode · Fleet · Doctor · Safety and security · Changelog
Install
You need a running Coolify v4 instance and an API token (Coolify → Keys & Tokens → API tokens). Pick one of three ways to run the server.
Claude Desktop, one-click. Download coolify-mcp.mcpb and drag it into Settings → Extensions. You are prompted for your Coolify URL and token. No Node install, no JSON editing.
Locally, in any MCP client. Claude Code:
claude mcp add coolify \
-e COOLIFY_BASE_URL="https://your-coolify-instance.com" \
-e COOLIFY_ACCESS_TOKEN="your-api-token" \
-- npx @masonator/coolify-mcp@latest
Codex CLI is the same with codex mcp add and --env. For Cursor, Claude Desktop or anything that takes a JSON config:
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["-y", "@masonator/coolify-mcp"],
"env": {
"COOLIFY_BASE_URL": "https://your-coolify-instance.com",
"COOLIFY_ACCESS_TOKEN": "your-api-token"
}
}
}
}
Remotely, as a container inside your Coolify. Deploy the server next to the Coolify it manages and connect claude.ai, Claude Desktop or Claude Code to https://your-domain/mcp. Your Coolify token stays server-side; clients authenticate with OAuth 2.1. Five-minute setup in docs/http-mode.md.
Then run doctor
Whatever you configured, verify it in one command:
安装
npx -y @masonator/coolify-mcp配置
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["-y", "@masonator/coolify-mcp"],
"env": {
"COOLIFY_BASE_URL": "https://your-coolify-instance.com",
"COOLIFY_ACCESS_TOKEN": "your-api-token"
}
}
}
}