de en es ja ko ru zh

Coolify MCP Server

Name: Coolify MCP Server
Author: frizikk

by frizikk

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🚀 Coolify MCP 서버 (`coolify-mcp`)

TypeScript Node Version License: MIT Model Context Protocol Coolify API Tools

Coolify v4 자체 호스팅 PaaS를 위한 포괄적이고 프로덕션 등급의 Model Context Protocol (MCP) 서버입니다.

AI 코딩 어시스턴트 및 에이전트(Claude Desktop, Cursor, Antigravity, Claude Code, Windsurf, Cline, VS Code)를 Coolify 인스턴스에 직접 연결하여 자연어로 인프라를 오케스트레이션하고, 애플리케이션을 배포하고, 8가지 유형의 데이터베이스를 관리하고, 환경 변수를 처리하고, 로그를 진단할 수 있습니다.

🌟 왜 `coolify-mcp`인가?

🌐 Coolify v4 API 100% 전체 지원: 프로젝트, 환경, 서버, 애플리케이션, 데이터베이스, Docker Compose 서비스, 배포, 팀 구성원 및 SSH 키를 포함한 77개의 검증된 MCP 도구.
🔒 읽기 전용 안전 가드: --read-only(또는 COOLIFY_READ_ONLY=true)를 활성화하면 AI 어시스턴트가 변경 또는 파괴적인 작업 없이 감사, 모니터링 및 문제 해결을 수행할 수 있습니다.
🗄️ 범용 데이터베이스 엔진 지원: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly 및 KeyDB에 대해 엔진별 파라미터 정규화가 적용된 즉시 사용 가능한 생성 및 구성을 제공합니다.
📊 동적 MCP 리소스: 토큰을 소모하지 않는 환경 컨텍스트를 위한 네이티브 리소스(coolify://overview, coolify://servers, coolify://applications, coolify://databases).
💡 DevOps 프롬프트 템플릿: 자율 진단 및 상태 확인을 위한 사전 구축된 프롬프트 레시피(diagnose-application, infrastructure-audit, deployment-summary).
🐳 Docker 및 Stdio 전송 지원: 표준 Node CLI 도구로 실행하거나 컨테이너 간 네트워크 지원이 포함된 격리된 Docker 컨테이너 내에서 실행할 수 있습니다.

Related MCP server: Coolify MCP Server

🤖 AI 에이전트 설정 프롬프트 (복사 & 붙여넣기)

Antigravity, Claude Code, Cursor, Windsurf 또는 Cline과 같은 AI 코딩 어시스턴트를 사용하는 경우 아래 프롬프트를 복사하여 어시스턴트에 붙여넣기만 하면 됩니다:

Please configure and set up the Coolify MCP server for me from https://github.com/frizikk/coolify-mcp.git.

Follow these steps:
1. Clone the repository:
   git clone https://github.com/frizikk/coolify-mcp.git
2. Install dependencies and build the server:
   cd coolify-mcp && pnpm install && pnpm build
3. Guide me to provide my Coolify instance URL (e.g. https://coolify.my-domain.com or http://localhost:8000) and API Bearer Token (generated in Coolify under Keys & Tokens / Settings -> API).
4. Add the `coolify` server configuration to my MCP client config (e.g., in Claude Desktop `claude_desktop_config.json`, Cursor `~/.cursor/mcp.json`, or Antigravity `~/.gemini/config/mcp_config.json`).
5. Test the connection by calling `coolify_get_version` and `coolify_get_infrastructure_overview` to verify connection to my Coolify instance.

🛠️ MCP 도구 참조

이 서버는 8가지 핵심 DevOps 도메인에 걸쳐 구성된 77개의 특수 도구를 제공합니다.

1. 시스템 및 인프라 개요 (도구 4개)

도구	매개변수	설명
`coolify_get_version`	없음	실행 중인 Coolify 인스턴스 버전 문자열을 가져옵니다.
`coolify_get_health`	없음	Coolify 백엔드 상태 확인을 수행합니다.
`coolify_list_resources`	없음	모든 프로젝트에서 관리되는 모든 리소스를 나열합니다.
`coolify_get_infrastructure_overview`	없음	통합된 상태, 서버 상태, 앱 및 데이터베이스 대시보드를 가져옵니다.

2. 서버 및 노드 관리 (도구 8개)

도구	매개변수	설명
`coolify_list_servers`	없음	연결 가능 여부 및 사용 가능 여부 플래그와 함께 등록된 모든 서버를 나열합니다.
`coolify_get_server`	`uuid`	서버의 상세 구성, IP 및 설정을 가져옵니다.
`coolify_validate_server`	`uuid`	서버에 대한 SSH 연결 및 연결 상태를 검증합니다.
`coolify_get_server_resources`	`uuid`	특정 서버에 배포된 모든 리소스를 나열합니다.
`coolify_get_server_domains`	`uuid`	서버의 모든 활성 도메인 및 라우트를 나열합니다.
`coolify_create_server`	`name`, `ip`, `port?`, `user?`, `private_key_uuid?`, `proxy_type?`	새 서버 노드를 등록합니다.
`coolify_update_server`	`uuid`, `name?`, `description?`, `ip?`, `port?`	서버 구성을 업데이트합니다.
`coolify_delete_server`	`uuid`	Coolify에서 서버를 제거합니다.

3. 팀 및 SSH 키 (도구 9개)

도구	매개변수	설명
`coolify_list_teams`	없음	토큰으로 액세스 가능한 모든 팀을 나열합니다.
`coolify_get_current_team`	없음	현재 인증된 활성 팀의 세부 정보를 가져옵니다.
`coolify_get_current_team_members`	없음	활성 팀의 사용자 및 역할을 나열합니다.
`coolify_get_team`	`team_id`	ID로 팀 세부 정보를 가져옵니다.
`coolify_get_team_members`	`team_id`	ID로 특정 팀의 구성원을 나열합니다.
`coolify_list_private_keys`	없음	등록된 모든 SSH 개인 키를 나열합니다.
`coolify_get_private_key`	`uuid`	개인 키 세부 정보를 가져옵니다.
`coolify_create_private_key`	`name`, `private_key`, `description?`	새 SSH 개인 키(Ed25519/RSA)를 등록합니다.
`coolify_delete_private_key`	`uuid`	SSH 개인 키를 삭제합니다.

4. 프로젝트 및 환경 (도구 9개)

도구	매개변수	설명
`coolify_list_projects`	없음	모든 프로젝트 및 환경을 나열합니다.
`coolify_get_project`	`uuid`	프로젝트 구조 및 환경 목록을 가져옵니다.
`coolify_create_project`	`name`, `description?`	새 프로젝트를 생성합니다.
`coolify_update_project`	`uuid`, `name?`, `description?`	프로젝트 이름 또는 설명을 업데이트합니다.
`coolify_delete_project`	`uuid`	빈 프로젝트를 삭제합니다.
`coolify_list_environments`	`project_uuid`	프로젝트의 환경을 나열합니다.
`coolify_get_environment`	`project_uuid`, `environment_name_or_uuid`	환경 세부 정보를 가져옵니다.
`coolify_create_environment`	`project_uuid`, `name`	새 환경(`testing`, `staging`)을 생성합니다.
`coolify_delete_environment`	`project_uuid`, `environment_name_or_uuid`	환경을 삭제합니다.

5. 애플리케이션 (도구 16개)

도구	매개변수	설명
`coolify_list_applications`	없음	모든 독립 실행형 애플리케이션을 나열합니다.
`coolify_get_application`	`uuid`	애플리케이션 구성, 포트 및 도메인을 가져옵니다.
`coolify_create_application_public_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `build_pack`, `name?`	공개 Git 저장소에서 배포합니다.
`coolify_create_application_private_git`	`project_uuid`, `server_uuid`, `environment_name`, `git_repository`, `git_branch`, `private_key_uuid`, `build_pack`, `name?`	비공개 Git 저장소에서 배포합니다.
`coolify_create_application_dockerfile`	`project_uuid`, `server_uuid`, `environment_name`, `dockerfile`, `name?`	원본 또는 base64 Dockerfile에서 배포합니다.
`coolify_create_application_docker_image`	`project_uuid`, `server_uuid`, `environment_name`, `docker_registry_image_name`, `docker_registry_image_tag?`	사전 빌드된 Docker 이미지를 배포합니다.
`coolify_update_application`	`uuid`, `name?`, `description?`, `domains?`, `build_pack?`, `ports_exposes?`	애플리케이션 구성을 업데이트합니다.
`coolify_delete_application`	`uuid`	애플리케이션과 해당 컨테이너를 삭제합니다.
`coolify_start_application`	`uuid`	애플리케이션 시작/배포를 트리거합니다.
`coolify_stop_application`	`uuid`	실행 중인 애플리케이션 컨테이너를 중지합니다.
`coolify_restart_application`	`uuid`	애플리케이션 컨테이너를 다시 시작합니다.
`coolify_get_application_logs`	`uuid`	런타임 컨테이너의 stdout/stderr 로그를 가져옵니다.
`coolify_list_application_envs`	`uuid`	애플리케이션의 모든 환경 변수를 나열합니다.
`coolify_set_application_env`	`uuid`, `key`, `value`, `is_build_time?`, `is_literal?`	환경 변수를 설정/생성합니다.
`coolify_bulk_set_application_envs`	`uuid`, `envs: [{key, value}]`	여러 환경 변수를 일괄 업데이트합니다.
`coolify_delete_application_env`	`uuid`, `env_uuid`	UUID로 환경 변수를 삭제합니다.

6. 배포 (5개 도구)

도구	매개변수	설명
`coolify_list_deployments`	없음	전체 실행 중 및 완료된 배포를 나열합니다.
`coolify_list_app_deployments`	`app_uuid`	특정 앱의 배포 기록을 나열합니다.
`coolify_get_deployment`	`deployment_uuid`	배포 상태, 커밋 정보 및 로그를 가져옵니다.
`coolify_trigger_deployment`	`uuid?`, `tag?`, `force?`	즉시 빌드 및 배포를 트리거합니다.
`coolify_cancel_deployment`	`deployment_uuid`	진행 중인 배포를 취소합니다.

7. 데이터베이스 (14개 도구)

도구	매개변수	설명
`coolify_list_databases`	없음	모든 독립 실행형 데이터베이스를 나열합니다.
`coolify_get_database`	`uuid`	데이터베이스 세부 정보 및 연결 문자열을 가져옵니다.
`coolify_create_database`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `database_name?`, `database_user?`, `database_password?`, `root_password?`, `is_public?`	DB를 생성합니다 (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB).
`coolify_update_database`	`uuid`, `name?`, `description?`, `is_public?`, `public_port?`	데이터베이스 설정을 업데이트합니다.
`coolify_delete_database`	`uuid`	데이터베이스 컨테이너와 볼륨을 삭제합니다.
`coolify_start_database`	`uuid`	데이터베이스 컨테이너를 시작합니다.
`coolify_stop_database`	`uuid`	데이터베이스 컨테이너를 중지합니다.
`coolify_restart_database`	`uuid`	데이터베이스 컨테이너를 다시 시작합니다.
`coolify_get_database_backups`	`uuid`	데이터베이스의 백업 구성을 나열합니다.
`coolify_create_database_backup`	`uuid`, `frequency`, `enabled?`, `save_s3?`	자동 데이터베이스 백업을 예약합니다 (cron).
`coolify_update_database_backup`	`uuid`, `backup_uuid`, `frequency?`, `enabled?`	백업 일정 설정을 업데이트합니다.
`coolify_delete_database_backup`	`uuid`, `backup_uuid`	백업 구성을 삭제합니다.
`coolify_list_backup_executions`	`uuid`, `backup_uuid`	백업 실행 기록을 나열합니다.
`coolify_delete_backup_execution`	`uuid`, `backup_uuid`, `execution_uuid`	특정 백업 실행 산출물을 삭제합니다.

8. 원클릭 서비스 및 Docker Compose (12개 도구)

도구	매개변수	설명
`coolify_list_services`	없음	모든 원클릭 서비스를 나열합니다.
`coolify_get_service`	`uuid`	서비스 메타데이터, 도메인 및 컨테이너를 가져옵니다.
`coolify_create_service`	`type`, `project_uuid`, `server_uuid`, `environment_name`, `name?`, `description?`	원클릭 템플릿(Ghost, Plausible 등)을 배포합니다.
`coolify_update_service`	`uuid`, `name?`, `description?`	서비스 설정을 업데이트합니다.
`coolify_delete_service`	`uuid`	서비스 스택을 삭제합니다.
`coolify_start_service`	`uuid`	서비스 컨테이너를 시작합니다.
`coolify_stop_service`	`uuid`	서비스 컨테이너를 중지합니다.
`coolify_restart_service`	`uuid`	서비스 스택을 재시작합니다.
`coolify_list_service_envs`	`uuid`	서비스 환경 변수를 나열합니다.
`coolify_set_service_env`	`uuid`, `key`, `value`	서비스 환경 변수를 생성/업데이트합니다.
`coolify_bulk_set_service_envs`	`uuid`, `envs: [{key, value}]`	서비스 환경 변수를 일괄 업데이트합니다.
`coolify_delete_service_env`	`uuid`, `env_uuid`	서비스 환경 변수를 삭제합니다.

📊 MCP 리소스 및 프롬프트

리소스

coolify://overview — 모든 서버, 앱, 데이터베이스 및 서비스의 통합 실시간 요약입니다.
coolify://servers — 서버 및 연결 가능 상태의 실시간 목록입니다.
coolify://applications — 모든 애플리케이션 및 URL의 실시간 상태입니다.
coolify://databases — 데이터베이스 컨테이너의 실시간 상태입니다.

프롬프트

diagnose-application — 자동화된 진단 워크플로: 애플리케이션 상태를 확인하고, 최근 로그를 분석하며, 환경 변수를 검사합니다.
infrastructure-audit — 서버, 디스크 한도 및 실패한 컨테이너 전반에 걸친 완전한 인프라 상태 점검입니다.
deployment-summary — 최근 배포를 분석하고 빌드 실패를 표시합니다.

⚙️ 구성 및 클라이언트 설정

환경 변수

변수	설명	기본값
`COOLIFY_BASE_URL`	Coolify 인스턴스의 기본 URL(예: `https://coolify.example.com`)	`http://localhost:8000`
`COOLIFY_API_TOKEN`	Coolify API Bearer 토큰	`""`
`COOLIFY_READ_ONLY`	비변경 작업으로 제한(`true`/`false`)	`false`

클라이언트 구성 예시

1. Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

2. Cursor (`~/.cursor/mcp.json` 또는 프로젝트 `.cursor/mcp.json`)

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

3. Antigravity (`~/.gemini/config/mcp_config.json`)

{
  "mcpServers": {
    "coolify": {
      "command": "node",
      "args": ["/path/to/coolify-mcp/dist/index.js"],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
        "COOLIFY_API_TOKEN": "your-bearer-token"
      }
    }
  }
}

4. Docker 컨테이너 모드

docker run -i --rm \
  -e COOLIFY_BASE_URL="http://coolify:8080" \
  -e COOLIFY_API_TOKEN="your-bearer-token" \
  --network coolify-network \
  coolify-mcp:latest

🧪 테스트 및 검증

테스트 스위트에는 라이브 Dockerized Coolify v4 인스턴스에 대해 실행되는 단위 테스트와 전체 엔드투엔드 통합 테스트가 포함됩니다:

# Run all automated unit and integration tests (43 tests)
pnpm test

# Run complete 77-tool live verification suite
pnpm test:verify-live

📄 라이선스

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp
JustDeployOAuth
ai.justdeploy
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Cloud Platforms CI/CD & DevOps App Automation
2
https://mcp.justdeploy.ai/mcp
microservices.sh
sh.microservices
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Cloud Platforms Agent Orchestration Developer Tools
21
https://api.microservices.sh/mcp
serverOAuth
com.devopness.mcp
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
Cloud Platforms CI/CD & DevOps Developer Tools
3
https://mcp.devopness.com/mcp/

Related MCP Servers

Coolify MCP Server
Cloud Platforms Developer Tools Virtualization
kof70
A
license
B
quality
B
maintenance
Enables control and management of Coolify self-hosted PaaS instances, allowing you to deploy applications, manage databases, monitor servers, and execute operations directly from AI assistants.
Updated a month ago (2026-09-17 18:56 UTC)
89
9 npm
28
MIT
Coolify MCP Server
Cloud Platforms CI/CD & DevOps Developer Tools
JoshuaRileyDev
A
license
B
quality
D
maintenance
Enables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.
Updated a year ago (2025-06-15 17:53 UTC)
18
6 npm
3
MIT
coolify-mcp
Cloud Platforms Databases
jurislm
A
license
Not graded
quality
F
maintenance
MCP server for Coolify infrastructure management, providing 45 tools for servers, applications, databases, deployments, and diagnostics via natural language.
Updated 4 months ago (2026-07-11 05:18 UTC)
32 npm
MIT
coolify-mcp
Cloud Platforms Developer Tools CI/CD & DevOps
0xtlt
A
license
B
quality
A
maintenance
MCP server for managing Coolify instances, enabling control of applications, databases, services, servers, and more via natural language.
Updated 7 days ago (2026-10-22 05:30 UTC)
136
197 npm
MIT

🚀 Coolify MCP 서버 (coolify-mcp)

🌟 왜 coolify-mcp인가?