MCP Server Coolify

MCP数据服务

提供方 pavelsukhachev · 包名 @pashvc/mcp-server-coolify

数据服务 stdio · 本地进程 Token 社区 / 第三方 Cline
查看接入方式

Coolify MCP Server是一个全面的模型上下文协议服务器,用于通过自托管的Coolify PaaS平台管理基础设施、应用程序、数据库和服务。

一句话选型结论

按资料字段整理

MCP Server Coolify 属于数据服务类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Cline,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权Token 部署方式支持远程部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 53 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量53暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

PaaS管理TypeScript本地部署基础设施管理应用程序管理数据库管理服务管理

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx @pashvc/mcp-server-coolify

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 53 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 53 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Cline 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Coolify当前 53 stdio · 本地进程 支持远程部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方pavelsukhachev上游标注的维护方 pavelsukhachev
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@pashvc/mcp-server-coolify · Node.js本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.0 KB
来自项目仓库与上游目录的原文,未做删改

冷却MCP服务器

用于Coolify API的综合模型上下文协议(MCP)服务器。该服务器使AI助手能够通过您的自托管Coolify PaaS平台管理基础设施、应用程序、数据库、服务等。

> 兼容性: 使用Coolify 4.0.0-beta.418版本进行测试


👋 开放机会!\
我正在积极寻求新的机会和合作。如果你有有趣的项目或工作机会,请随时联系!\
📧 联系人: pashvc@gmail.com


先决条件

  • Node.js 18或更高版本
  • 冷却基本URL
  • Coolify API代币

特性

核心管理层

  • 团队:列出团队,获取团队详细信息,查看团队成员
  • 项目:创建、列出、更新和删除项目
  • 服务器:创建服务器、验证连接、查看资源和域
  • 私钥:管理服务器访问的SSH密钥

应用程序

  • 完整的CRUD操作(创建、读取、更新、删除)
  • 生命周期管理(启动、停止、重新启动)
  • 在容器中执行命令
  • 查看应用程序日志
  • Git集成(存储库、分支、提交管理)
  • 资源限制配置(内存、CPU)
  • 健康检查配置

数据库

  • 支持PostgreSQL、MySQL、MariaDB、MongoDB和Redis
  • 创建和管理数据库实例
  • 配置特定于数据库的设置
  • 生命周期管理(启动、停止、重新启动)
  • 资源限制和公共端口配置

服务

  • 部署预配置的服务(合理、Umami、n8n等)
  • 生命周期管理解决方案
  • 配置更新

环境变量

  • 管理应用程序、服务和数据库的环境变量
  • 支持构建时和运行时变量
  • 预览部署变量
  • 跨环境共享变量

部署

  • 列出所有部署
  • 获取部署详细信息和日志
  • 通过webhook触发部署
  • 支持Docker镜像标签

开发者体验

  • 常见工作流的预配置提示
  • 全面的错误处理和详细的消息
  • 完全类型安全的TypeScript支持
  • 与MCP Inspector集成进行调试
  • 适用于不同Coolify版本的强大API响应处理
  • 单元和集成测试的广泛测试覆盖率

安装```bash

Install globally

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

Or use with npx

npx @pashvc/mcp-server-coolify


## 配置

服务器需要两个环境变量:

- `COOLIFY_BASE_URL`:Coolify实例的基本URL
- `COOLIFY_TOKEN`:您的Coolify API代币

### 获取API令牌

1. 转到您的Coolify实例
1. 引导到 `Keys & Tokens` / `API tokens`
1. 创建具有以下所需权限的新令牌:
- read(用于获取信息)
- 写(用于管理资源)
- 部署(用于部署操作)

## 用法

### 在MCP设置中

将以下内容添加到MCP设置配置中:```json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["-y", "@pashvc/mcp-server-coolify"],
"env": {
"COOLIFY_BASE_URL": "your-coolify-url",
"COOLIFY_TOKEN": "your-api-token"
},
"disabled": false,
"autoApprove": []
}
}
}

Windows Cline用户可能需要以下内容:```json
{
"mcpServers": {
"coolify": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@pashvc/mcp-server-coolify"
],
"env": {
"COOLIFY_BASE_URL": "your-coolify-url",
"COOLIFY_TOKEN": "your-api-token"
},
"disabled": false,
"autoApprove": []
}
}
}


### 可用工具

#### 版本和运行状况

- `coolify_version`:获取Coolify版本信息
- `coolify_health`:检查Coolify API运行状况

#### 团队

- `list_teams`:列出所有团队
- `get_team`:获取特定团队的详细信息
- `get_current_team`:获取当前团队详细信息
- `get_current_team_members`:获取当前团队成员

#### 服务器

- `list_servers`:列出所有服务器
- `create_server`:创建新服务器
- `validate_server`:验证服务器配置
- `get_server_resources`:获取服务器资源
- `get_server_domains`:获取服务器域

#### 项目

- `list_projects`:列出所有项目
- `get_project`:获取项目详细信息
- `create_project`:创建新项目
- `update_project`:更新项目设置
- `delete_project`:删除项目

#### 应用程序

- `list_applications`:列出所有应用程序
- `get_application`:获取应用程序详细信息
- `create_application`:创建新应用程序
- `update_application`:更新应用程序设置
- `delete_application`:删除应用程序
- `start_application`:启动应用程序
- `stop_application`:停止应用程序
- `restart_application`:重新启动应用程序
- `execute_command`:在应用程序容器中执行命令
- `get_application_logs`:获取应用程序日志

#### 数据库

- `list_databases`:列出所有数据库
- `get_database`:获取数据库详细信息
- `create_database`:创建新数据库
- `update_database`:更新数据库设置
- `delete_database`:删除数据库
- `start_database`:启动数据库
- `stop_database`:停止数据库
- `restart_database`:重新启动数据库

#### 服务

- `list_services`:列出所有服务
- `get_service`:获取服务详细信息
- `create_service`:创建新服务
- `update_service`:更新服务设置
- `delete_service`:删除服务
- `start_service`:启动服务
- `stop_service`:停止服务
- `restart_service`:重新启动服务

#### 环境变量

- `list_environment_variables`:列出环境变量
- `create_environment_variable`:创建新的环境变量
- `update_environment_variable`:更新环境变量
- `delete_environment_variable`:删除环境变量

#### 部署

- `list_deployments`:列出所有部署
- `get_deployment`:获取部署详细信息
- `deploy_webhook`:通过webhook触发部署

#### 私钥

- `list_private_keys`:列出所有私钥
- `create_private_key`:创建新的私钥
- `update_private_key`:更新私钥
- `delete_private_key`:删除私钥

### 预配置提示

服务器包括常见工作流的有用提示:

- `deploy-git-app`:从Git存储库部署新应用程序
- `setup-database`:设置具有正确配置的新数据库
- `deploy-service`:部署预配置的服务
- `environment-setup`:为应用程序设置环境变量
- `server-health-check`:对所有服务器进行全面的健康检查
- `backup-database`:创建数据库备份
- `scale-application`:通过调整资源来扩展应用程序
- `setup-ssl`:为应用程序配置SSL/TLS
- `migrate-application`:在服务器之间迁移应用程序
- `troubleshoot-deployment`:对失败的部署进行故障排除

## 发展

### 从源头构建```bash
# Clone the repository
git clone https://github.com/pashvc/mcp-server-coolify.git
cd mcp-server-coolify

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

开发脚本

  • npm run build:构建TypeScript项目
  • npm run watch:构建并观察变化
  • npm test:运行所有测试
  • npm run test:watch:在监视模式下运行测试
  • npm run test:coverage:使用覆盖率报告运行测试
  • npm run test:integration:仅运行集成测试(需要env变量)
  • npm run inspector:启动MCP检查器进行调试

故障排除

常见问题

  • 404错误:某些端点可能并非在所有Coolify版本中都可用。服务器自动处理不同版本的不同响应格式。
  • 身份验证错误:确保您的API令牌具有所需的权限(读取、写入、部署)。
  • 连接问题:验证您的 COOLIFY_BASE_URL 是正确和可访问的。
  • 环境变量:确保两者都 COOLIFY_BASE_URL 和 COOLIFY_TOKEN 设置正确。

测试您的设置```bash

Test with your credentials

export COOLIFY_BASE_URL="https://your-coolify-instance.com"
export COOLIFY_TOKEN="your-api-token"

Run integration tests to verify connectivity

npm run test:integration

Or test the server directly

npm run build && npm start
```

API兼容性

服务器自动处理不同的响应格式:

  • 版本终结点:支持字符串和对象响应
  • 列出端点:处理直接数组和分页响应
  • 健康终点:适应不同的状态响应格式
  • 错误处理:对各种错误消息格式的强大解析

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Server Coolify 怎么安装?

在客户端按下面的安装命令接入:npx @pashvc/mcp-server-coolify。对应的包名是 @pashvc/mcp-server-coolify。装完在客户端配置里引用同一个包或端点。

MCP Server Coolify 怎么在 Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Server Coolify 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Server Coolify 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

MCP Server Coolify 支持哪些客户端?

资料标注支持 Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Server Coolify 能提供哪些能力?

资料显示约 53 个工具;能力标签包括 TypeScript、Cline、基础设施管理。具体工具清单以官方文档为准。

MCP Server Coolify 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Server Coolify 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。