Coolify MCP Server

# 🐳 Coolify MCP 서버 - 로컬 데모 환경 ## 🎯 목표 로컬에서 완전한 Coolify 환경을 구축하여 MCP 서버를 테스트합니다. ## 📋 사전 요구사항 ### Docker Desktop 설치 및 실행 1. **Docker Desktop 다운로드**: https://www.docker.com/products/docker-desktop 2. **설치 후 실행**: Applications/Docker.app 3. **메모리 설정**: Docker Desktop → Settings → Resources → Memory를 **4GB 이상**으로 설정 ## 🚀 빠른 시작 ### 1단계: Docker 상태 확인 ```bash cd demo-server ./check-docker.sh ``` ### 2단계: 데모 서버 시작 ```bash ./setup.sh ``` ### 3단계: Coolify 접속 및 설정 1. **브라우저에서 접속**: http://localhost:8000 2. **관리자 계정 생성** (첫 방문 시) 3. **API 토큰 생성**: - Settings → Keys & Tokens → API Tokens - Create New Token - Name: "MCP Demo Token" - Permissions: "*" (full access) - **토큰 복사** (한 번만 표시됨!) ### 4단계: 환경 변수 설정 ```bash cd .. # 상위 디렉터리로 이동 echo "COOLIFY_BASE_URL=http://localhost:8000" >> .env echo "COOLIFY_API_TOKEN=복사한-토큰-여기에-붙여넣기" >> .env ``` ### 5단계: MCP 서버 테스트 ```bash npm run dev ``` 다른 터미널에서: ```bash echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/index.js ``` ## 🔧 필요한 정보 수집 방법 ### API 토큰 생성 1. http://localhost:8000 접속 2. 관리자 계정으로 로그인 3. **Settings** (⚙️) 클릭 4. **Keys & Tokens** 클릭 5. **API Tokens** 탭 선택 6. **Create New Token** 버튼 클릭 7. 다음 정보 입력: - **Name**: "MCP Demo Token" - **Permissions**: "*" 선택 (전체 접근) 8. **Create** 클릭 9. **생성된 토큰을 즉시 복사** (다시 볼 수 없음) ### 서버 ID 확인 (테스트 앱 생성용) 1. Coolify 대시보드에서 **Servers** 클릭 2. 로컬 서버의 **ID 복사** (예: srv_xxx...) ### 테스트 애플리케이션 생성 ```bash # MCP 서버를 통한 애플리케이션 생성 테스트 echo '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "coolify_application_management", "arguments": { "action": "create", "name": "demo-app", "git_repository": "https://github.com/vercel/next.js", "git_branch": "canary", "serverId": "서버-ID-여기에" } } }' | node dist/index.js ``` ## 🛠 관리 명령어 ### 서버 상태 확인 ```bash cd demo-server docker compose ps ``` ### 로그 확인 ```bash docker compose logs -f coolify ``` ### 서버 재시작 ```bash docker compose restart ``` ### 서버 중지 ```bash docker compose down ``` ### 완전 초기화 (모든 데이터 삭제) ```bash docker compose down -v ``` ## 🧪 테스트 시나리오 ### 1. 연결 테스트 ```bash curl http://localhost:8000/api/v1/health ``` ### 2. 인증 테스트 ```bash curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:8000/api/v1/applications ``` ### 3. MCP 도구 테스트 ```bash # 애플리케이션 목록 echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "coolify_application_management", "arguments": {"action": "list"}}}' | node dist/index.js # 시스템 정보 echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "coolify_system_management", "arguments": {"action": "get_servers"}}}' | node dist/index.js # 문서 검색 echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "coolify_documentation", "arguments": {"action": "search", "query": "deployment"}}}' | node dist/index.js ``` ## 🔍 문제 해결 ### 포트 충돌 (8000 포트 사용 중) ```yaml # docker-compose.yml 수정 ports: - "8001:80" # 포트 변경 ``` ### 메모리 부족 - Docker Desktop → Settings → Resources → Memory를 6-8GB로 증가 ### 컨테이너 시작 실패 ```bash docker compose down -v # 모든 데이터 삭제 docker compose up -d # 재시작 ``` ### API 토큰 분실 1. Coolify에서 기존 토큰 삭제 2. 새 토큰 생성 3. .env 파일 업데이트 ## 📊 성공 지표 - ✅ Coolify가 http://localhost:8000에서 접근 가능 - ✅ API 토큰으로 인증 성공 - ✅ MCP 서버가 4개 통합 도구 제공 - ✅ 문서 검색 기능 작동 - ✅ 애플리케이션 생성/관리 테스트 성공 **이제 Docker Desktop을 시작하고 `./check-docker.sh`를 실행해주세요!** 🚀