StuMason/coolify-mcp

해결하는 문제

Claude, Cursor 또는 어떤 MCP 호환 도구든 포함된 AI 클라이언트를 통해 자연어로 자체 호스팅 PaaS인 Coolify를 관리할 수 있게 해줍니다. 복잡한 인프라 관리 인터페이스와 AI 에이전트 사이의 격차를 메우며, 수동적인 API 호출이나 대시보드 탐색 없이 서버 및 애플리케이션의 배포, 디버깅, 운영이 가능하게 합니다.

작동 방식

이 프로젝트는 46개의 전문 도구를 AI 모델에 노출하는 Model Context Protocol (MCP) 서버를 구현합니다. 이 도구들은 Coolify API와 연동되어 애플리케이션 배포, 로그 읽기, 환경 변수 관리 등의 작업을 수행합니다. 세 가지 배포 모드를 지원합니다: Claude Desktop용 원클릭 설치, npx를 통한 로컬 설치, HTTP/OAuth 2.1을 사용한 원격 컨테이너 모드. 또한 설정 및 연결 상태를 검증하는 doctor 명령어도 포함되어 있습니다.

대상 사용자

• DevOps 엔지니어 및 개발자 : 채팅을 통해 인프라를 관리하고 싶은 사람.
• 에이전시 : 여러 클라이언트를 위한 여러 Coolify 인스턴스를 관리하는 경우 ("플릿 모드"로).
• 자체 호스팅 PaaS 사용자 : 수동 CLI나 GUI 대신 에이전트 기반 워크플로우로 문제 해결 및 배포를 선호하는 사람.

주요 특징

• 포괄적인 도구 세트 : 애플리케이션 진단, 배포/롤백, 리소스 생성, 설정 처리를 위한 46개의 도구.
• 안전성 우선 : 파괴적인 작업은 지원되는 클라이언트에서 인간의 확인이 필요하며, 시크릿은 API 경계에서 마스킹됩니다.
• 다중 인스턴스 지원 : 하나의 연결에서 여러 Coolify 인스턴스(플릿)를 관리할 수 있습니다.
• 내장된 워크플로우 : 애플리케이션 문제 해결, 실패한 배포 설명, 에스테이트 건강 상태 점검을 위한 사전 정의된 프롬프트 포함.
• 연결 진단 기능 : 일반적인 설정 오류를 식별하고 한 줄로 수정할 수 있는 doctor 도구 제공.