@velxor/mcp

MCP(Model Context Protocol) 서버로, Claude Code, Cursor 및 기타 MCP 호환 에이전트가 코딩 세션에서 직접 Vlexor의 세 가지 핵심 기능 — AI 비디오 편집, 게임 에셋 생성, 모션 그래픽 제작 — 을 구동할 수 있게 해줍니다.

비디오 편집은 사용자의 실제 영상에서 실행됩니다. 원본 비디오는 절대 기기를 벗어나지 않으며, 편집 계획을 생성하기 위해 Vlexor로 전송되는 것은 사용자의 지침 텍스트(및 선택적 대본)뿐입니다. 이 계획은 실제 FFmpeg 명령어로 컴파일되어 완전히 로컬에서 렌더링됩니다. 에셋 생성 및 모션 그래픽은 서버 측에서 렌더링되며(보호해야 할 로컬 영상이 없음) 서명된 다운로드 URL을 반환합니다. 선택적으로 로컬 경로에 직접 저장할 수도 있습니다.

설정

1. Vlexor → 설정 → MCP 및 API에서 개인 API 키를 생성합니다.

2. FFmpeg가 아직 설치되지 않은 경우 설치합니다(macOS에서는 brew install ffmpeg, 또는 VLEXOR_FFMPEG_DIR을 ffmpeg/ffprobe가 있는 폴더로 설정).

3. MCP 클라이언트 설정에 다음을 추가합니다:

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: CutPilot

도구

핵심 1 — 비디오 편집(로컬에서 렌더링, 영상 업로드 없음):

• probe_media — 로컬 비디오의 길이, 해상도, fps, 코덱을 읽습니다.

• generate_edit_plan — 자연어 지침 → 구조화된 편집 계획(실제 Vlexor Command Engine 호출, 요금제 사용량에 반영).

• compile_edit_plan — 편집 계획 → 완전히 로컬에서 계산된 실제 FFmpeg 명령어.

• render — 컴파일된 명령어를 로컬에서 실행하여 최종 비디오를 생성합니다.

일반적인 에이전트 흐름: probe_media → generate_edit_plan → (단계 검토) → compile_edit_plan → (FFmpeg 명령어 검토) → render.

핵심 2 — 에셋 생성(서버 측에서 렌더링):

• generate_game_asset — 프롬프트 → 텍스처, 2D 캐릭터, 스프라이트 시트, 3D 모델(.glb), 사운드 효과, 음악 트랙, 파라랙스 배경 또는 캐릭터 턴어라운드. 서명된 다운로드 URL을 반환하며, savePath를 전달하면 파일을 로컬에 저장합니다.

핵심 3 — 모션 그래픽(서버 측에서 렌더링):

• generate_motion_graphic — 짧은 크리에이티브 브리프 → 렌더링된 키네틱 타이틀 .mp4(발표/프로모션 카드). 서명된 다운로드 URL을 반환하며, savePath를 전달하면 파일을 로컬에 저장합니다.

환경 변수

이 저장소 정보

이 패키지는 MCP 클라이언트를 Vlexor의 실제 호스팅 API에 연결하는 얇은 통합 계층입니다. 여기의 모든 도구 호출은 평범하고 검사 가능한 HTTP 요청입니다(기기를 떠나는 데이터를 정확히 확인하려면 src/api-client.ts를 참조하세요). API 키를 통해 파이프하는 에이전트 개발자가 직접 확인할 수 있도록 공개되어 있습니다.

Vlexor 플랫폼 자체(편집 엔진, AI 프롬프트 디자인, 에셋/모션 그래픽 생성 파이프라인)는 비공개 소스입니다. 이 패키지의 일부 가져오기(@velxor/engine의 FFmpeg 계획 컴파일러, @velxor/shared의 타입 정의)는 해당 비공개 코드베이스에서 제공되며 별도로 게시되지 않으므로, 이 저장소는 단독으로 pnpm install/빌드되지 않습니다. 읽기용이며 사전 빌드된 npm 패키지 (npx -y @velxor/mcp)를 통해 실행되도록 설계되었습니다. 이 체크아웃에서 컴파일되지 않습니다.

MCP 통합 계층 자체(도구 스키마, 오류 처리, 로컬 FFmpeg 오케스트레이션)에 대한 이슈 및 PR은 환영합니다.

라이선스

MIT