링크된 문서
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 - 완성된 비디오의 공유 및 업로드 자동화