Independent Video Generator

메인 프로젝트에서 분리된 독립형 비디오 생성 프론트엔드와 백엔드로, ComfyUI 비디오 workflow만 유지하며 Agent 대화와 이미지 생성은 포함하지 않습니다.

시작

1. .env.example를 복사하여 .env로 만들고, ComfyUI와 FFPROBE 경로를 확인합니다.

2. 의존성 설치: npm install

3. 개발 모드: npm run dev

4. 프로덕션 빌드: npm run build

5. 프로덕션 시작: npm run start

기본 URL: http://127.0.0.1:8834

Windows 사용자는 start.bat을 더블클릭하면 됩니다. 현재 폴더로 전환하고, .env를 생성하고, 의존성을 설치한 후 서비스를 자동으로 시작합니다.

Related MCP server: RunComfy MCP Server

비디오 API

• GET /api/video/workflows

• POST /api/video/jobs

• GET /api/video/jobs/:jobId

• DELETE /api/video/jobs/:jobId

MCP 최소 버전

먼저 비디오 API를 시작한 다음 npm run mcp를 실행합니다. MCP server는 stdio transport를 사용하며, MCP_API_URL(기본값 http://127.0.0.1:8834)을 통해 기존 비디오 API를 호출합니다.

제공되는 tools:

• list_video_workflows

• create_video_job

• upload_video_asset

• get_video_job

• list_video_jobs

• get_video_result

• cancel_video_job

원격 프론트엔드 및 GPU 호스트

프론트엔드와 MCP는 휴대용 제어 측에 두고, Backend, ComfyUI, 모델, GPU는 동일한 GPU 호스트에 둡니다. 프론트엔드는 다음과 같이 빌드합니다:

VITE_BACKEND_URL=http://GPU_HOST:8834

GPU 호스트 Backend는 다음과 같이 구성합니다:

HOST=0.0.0.0
PORT=8834
COMFYUI_URL=http://127.0.0.1:8188
CORS_ORIGIN=http://FRONTEND_HOST

MCP는 다음과 같이 구성합니다:

MCP_API_URL=http://GPU_HOST:8834

브라우저와 MCP는 Video Generator API만 호출하며, ComfyUI는 GPU 호스트에서 비공개로 유지됩니다. API 키 인증은 아직 활성화되지 않았으므로, HOST=0.0.0.0은 신뢰할 수 있는 LAN 또는 VPN에서만 사용해야 합니다.

현재 이미지와 오디오는 여전히 data URL로 전송되며, 로컬 MVP에 적합하고 대규모 또는 다중 사용자 배포에는 적합하지 않습니다.

비디오 workflow 자산은 workflow/에 있습니다. 이 프로젝트는 현재 메인 프로젝트와 동일한 ComfyUI 서비스를 공유하지만, 코드, 프론트엔드 페이지, 작업 API 및 workflow JSON은 이미 독립되어 있습니다.