MCP 문서 관리

메뉴

DaVinci Resolve

DaVinci Resolve

DaVinci Resolve MCP 서버는 전문적인 비디오 편집, 색상 등급 지정, 시각 효과 및 오디오 후처리를 위한 강력한 소프트웨어인 DaVinci Resolve와 통합을 제공합니다. 이 서버를 통해 LLM은 비디오 프로젝트를 분석하고 제어하여 편집 과정을 자동화하고 효율화할 수 있습니다.

특징

  • 프로젝트 관리: 프로젝트 생성, 열기, 저장 및 설정 구성
  • 미디어 관리: 미디어 파일 가져오기, 정리, 메타데이터 작업
  • 타임라인 편집: 클립 추가, 트리밍, 전환 효과 적용, 시퀀스 구성
  • 색상 등급 지정: 색상 보정, 룩 적용, 노드 기반 그레이딩 워크플로우
  • 오디오 작업: 오디오 트랙 편집, 믹싱, 효과 적용
  • Fusion 효과: 시각 효과 생성 및 합성 기능 접근
  • 자동화된 워크플로우: 반복 작업 자동화 및 템플릿 기반 편집
  • 렌더링 및 내보내기: 다양한 포맷으로 프로젝트 렌더링 및 내보내기

API

도구

프로젝트 도구

  • create_project: 새 프로젝트 생성
  • 입력: 프로젝트 이름, 해상도, 프레임 레이트, 기타 설정
  • 출력: 생성된 프로젝트 ID 및 상태

  • open_project: 기존 프로젝트 열기

  • 입력: 프로젝트 파일 경로
  • 출력: 프로젝트 로딩 상태 및 정보

  • save_project: 현재 프로젝트 저장

  • 입력: 저장 경로(선택적)
  • 출력: 저장 성공 여부 및 파일 정보

미디어 관리 도구

  • import_media: 미디어 파일 가져오기
  • 입력: 파일 경로 또는 URL, 가져오기 옵션
  • 출력: 가져온 미디어 항목 목록

  • organize_media: 미디어 풀 정리

  • 입력: 정리 기준(이름, 유형, 날짜 등)
  • 출력: 정리 결과 요약

  • analyze_media: 미디어 분석

  • 입력: 미디어 ID, 분석 유형(장면 감지, 안정화 분석 등)
  • 출력: 분석 결과 데이터

편집 도구

  • create_timeline: 새 타임라인 생성
  • 입력: 타임라인 이름, 설정
  • 출력: 생성된 타임라인 ID

  • add_to_timeline: 클립을 타임라인에 추가

  • 입력: 미디어 항목 ID, 타임라인 위치, 트랙 번호
  • 출력: 편집 작업 결과 및 클립 정보

  • apply_transition: 전환 효과 적용

  • 입력: 클립 ID, 전환 유형, 지속 시간
  • 출력: 적용 상태 및 결과

색상 등급 지정 도구

  • color_correction: 기본 색상 보정
  • 입력: 클립 ID, 색상 파라미터(노출, 대비, 색상 등)
  • 출력: 보정 적용 결과

  • apply_lut: LUT(룩업 테이블) 적용

  • 입력: 클립 ID, LUT 파일 경로
  • 출력: LUT 적용 상태

  • create_color_node: 색상 노드 생성 및 구성

  • 입력: 노드 유형, 파라미터, 연결 정보
  • 출력: 생성된 노드 ID 및 상태

렌더링 도구

  • render_timeline: 타임라인 렌더링
  • 입력: 출력 경로, 렌더링 설정(코덱, 해상도, 비트레이트 등)
  • 출력: 렌더링 진행 상황 및 완료 알림

  • export_project: 프로젝트 내보내기

  • 입력: 내보내기 형식, 대상 경로, 옵션
  • 출력: 내보내기 상태 및 파일 정보

사용 방법

설치

# npm을 통한 설치
npm install -g davinci-resolve-mcp

# 또는 GitHub에서 직접 설치
git clone https://github.com/author/davinci-resolve-mcp
cd davinci-resolve-mcp
npm install

필요 조건

  • DaVinci Resolve Studio 17 이상이 로컬에 설치되어 있어야 합니다.
  • DaVinci Resolve API 액세스를 위한 설정이 완료되어야 합니다.
  • Python 3.6 이상 및 관련 의존성 패키지

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정할 수 있습니다:

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "npx",
      "args": ["-y", "davinci-resolve-mcp"],
      "env": {
        "RESOLVE_API_PATH": "/path/to/resolve/api",
        "PROJECT_DIRECTORY": "/path/to/projects"
      }
    }
  }
}

사용 예시

// 새 프로젝트 생성
const project = await create_project({
  name: "Interview Edit",
  resolution: "1920x1080",
  frameRate: 24
});

// 미디어 가져오기
const mediaItems = await import_media({
  paths: ["/path/to/interview.mp4", "/path/to/b-roll/"],
  createBins: true
});

// 타임라인 생성 및 클립 추가
const timeline = await create_timeline({
  name: "Main Edit",
  settings: { 
    resolution: "1920x1080",
    frameRate: 24
  }
});

await add_to_timeline({
  mediaId: mediaItems[0].id,
  timelineId: timeline.id,
  startFrame: 0,
  track: 1
});

// 색상 보정 적용 및 렌더링
await color_correction({
  clipId: timeline.clips[0].id,
  adjustments: {
    exposure: 0.5,
    contrast: 1.2,
    saturation: 1.1
  }
});

await render_timeline({
  timelineId: timeline.id,
  outputPath: "/path/to/output/final_edit.mp4",
  format: "h264",
  quality: "high"
});

연결된 구성 요소

  • Video Editor - 비디오 편집 기능과의 추가 통합 가능성
  • ElevenLabs - 오디오 나레이션 및 보이스오버 제작과 통합
  • Reaper - 고급 오디오 편집 및 믹싱과의 연계
  • YouTube - 완성된 비디오의 공유 및 업로드 자동화