Coolify MCP 서버

개요

Coolify MCP 서버는 인기 있는 오픈소스 셀프 호스팅 PaaS인 Coolify(Heroku, Vercel, Netlify의 대안)를 위한 최고의 커뮤니티 구축 Model Context Protocol (MCP) 서버입니다. AI 코딩 어시스턴트(Claude Desktop, Cursor, Claude Code 등)가 자연어 명령을 사용하여 Coolify 인스턴스를 완전히 관리하고 디버깅할 수 있도록 합니다.

38개의 최적화된 도구, 스마트 리소스 조회(UUID 대신 이름/도메인/IP), 토큰 효율적인 응답 및 내장된 전문 텍스트 문서 검색 기능을 통해, AI를 셀프 호스팅 배포를 위한 강력한 DevOps 공동 조종사로 만들어줍니다.

주요 기능

• 38개 최적화 도구: 인프라, 서버, 프로젝트, 애플리케이션, 데이터베이스, 서비스, 배포, 환경 변수, 개인 키, 팀, 클라우드 토큰(Hetzner, DigitalOcean) 등을 포괄합니다.

• 스마트 진단: 사람이 읽기 쉬운 식별자를 사용하는 diagnose_app, diagnose_server, find_issues.

• 일괄 작업: 전체 프로젝트 재시작, 일괄 환경 업데이트, 여러 앱 중지/재배포.

• 토큰 효율성: 응답이 원시 Coolify API보다 85~99% 더 작습니다(예: list_applications가 ~170KB에서 ~4.4KB로 축소).

• 전문 텍스트 문서 검색: 1,500개 이상의 Coolify 문서 청크를 내장 검색.

• HATEOAS 스타일 응답: 더 나은 AI 컨텍스트를 위한 제안된 다음 작업 및 페이징 포함. .

• 프로덕션 준비 완료: 98% 이상 테스트 커버리지, 엄격한 TypeScript, 견고한 오류 처리.

사용 사례

• AI 기반 배포: "GitHub 저장소 X의 Next.js 앱을 프로덕션에 배포해 줘."
• 인프라 관리: "모든 서버를 나열하고, 리소스 사용량을 표시하고, 데이터베이스 서버를 재시작해 줘."
• 디버깅 및 진단: "내 앱이 왜 실패하는지 진단하고 해결 방법을 제안해 줘."
• 일괄 관리: "프로젝트 Y의 모든 앱에서 환경 변수를 업데이트하고 재배포해 줘."
• 문서 지원: "PostgreSQL 백업 설정 방법을 Coolify 문서에서 검색해 줘."
• 완전한 DevOps 워크플로: 다른 MCP 서버와 결합하여 엔드투엔드 AI 조율 배포 파이프라인 구성.

설치 (가장 쉬운 방법)

npx를 통해 (Claude Desktop / Cursor / Claude Code에 권장)

# Claude Desktop용 – claude_desktop_config.json에 추가
npx -y @masonator/coolify-mcp

다음 환경 변수를 설정하세요:

• COOLIFY_ACCESS_TOKEN (Coolify API 토큰)
• COOLIFY_BASE_URL (예: https://your-coolify-instance.com)

Claude Code용 빠른 한 줄 명령:

claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://your-coolify.com -- npx @masonator/coolify-mcp@latest

전체 소스 및 Docker/수동 설정은 저장소에서 확인할 수 있습니다.

호환성

• 클라이언트: Claude Desktop, Cursor, Claude Code, 모든 MCP 호환 AI 도구.
• Coolify 버전: v4.0.0-beta.460+에서 테스트됨 (기능 자동 감지).
• 라이선스: MIT

커뮤니티 & 대안

이것은 가장 활발하게 관리되고 기능이 풍부한 구현체입니다(2026년 2월 기준 v2.7.3), 공식 MCP 레지스트리에 등록되어 있습니다. 향상된 포크 버전(예: dazeb/coolify-mcp-enhanced)은 필요한 경우 추가 배포 도구를 제공합니다.

오늘부터 AI를 통해 셀프 호스팅 PaaS를 관리해 보세요 — Coolify MCP 서버가 DevOps를 대화형으로 손쉽게 만듭니다.