Coolify MCP 서버

Coolify API와의 통합을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 MCP 도구를 통해 Coolify 인스턴스와의 상호 작용을 지원합니다.

호환성: Coolify 버전 4.0.0-beta.397로 테스트됨

필수 조건

Node.js 18 이상
Coolify 기본 URL
Coolify API 토큰

특징

팀 관리(목록, 세부 정보 가져오기, 멤버)
서버 관리(리소스 생성, 검증, 도메인)
서비스 수명 주기 관리(시작, 중지, 재시작)
애플리케이션 수명 주기 관리(시작, 중지, 다시 시작, 명령 실행)
배포 추적
개인 키 관리
버전 및 상태 검사

설치

지엑스피1

구성

서버에는 두 개의 환경 변수가 필요합니다.

COOLIFY_BASE_URL : Coolify 인스턴스의 기본 URL
COOLIFY_TOKEN : Coolify API 토큰

API 토큰 받기

Coolify 인스턴스로 이동하세요
Keys & Tokens / API tokens 으로 이동
다음 필수 권한을 사용하여 새 토큰을 만듭니다.
- 읽기(정보를 가져오기 위해)
- 쓰기(리소스 관리용)
- 배포(배포 작업용)

용법

MCP 설정에서

MCP 설정 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows Cline 사용자에게는 다음이 필요할 수 있습니다.

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "coolify-mcp-server"
      ],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

사용 가능한 도구

버전 및 상태

get_version : Coolify 버전 정보 가져오기
health_check : 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_services : 모든 서비스 나열
create_service : 새로운 서비스를 생성합니다
start_service : 서비스 시작
stop_service : 서비스 중지
restart_service : 서비스를 다시 시작합니다

응용 프로그램

list_applications : 모든 애플리케이션 나열
create_application : 새로운 애플리케이션을 생성합니다
start_application : 애플리케이션 시작
stop_application : 애플리케이션을 중지합니다.
restart_application : 애플리케이션을 다시 시작합니다.
execute_command_application : 애플리케이션 컨테이너에서 명령을 실행합니다.

배포

list_deployments : 모든 배포 나열
get_deployment : 배포 세부 정보 가져오기

개인 키

list_private_keys : 모든 개인 키 나열
create_private_key : 새로운 개인 키를 생성합니다

특허

MIT