video-editing-mcp

비디오 편집기 MCP 서버

데모는 여기에서 확인하세요: https://www.youtube.com/watch?v=KG6TMLD8GmA

모두가 좋아하는 LLM과 Video Jungle 에서 비디오를 업로드, 편집, 검색하고 생성하세요.

이 도구를 사용하려면 Video Jungle 에 계정을 만들고 API 키를 추가해야 합니다.

구성 요소

자원

서버는 다음을 사용하여 비디오를 업로드, 생성, 편집하기 위한 인터페이스를 구현합니다.

• 개별 비디오 및 프로젝트에 액세스하기 위한 사용자 지정 vj:// URI 체계
• 각 프로젝트 리소스에는 이름과 설명이 있습니다.
• 검색 결과에는 비디오에 무엇이 있는지, 언제 있는지에 대한 메타데이터가 함께 반환되므로 직접 편집을 생성할 수 있습니다.

프롬프트

곧 출시됩니다.

도구

서버는 몇 가지 도구를 구현합니다.

• 비디오 추가
  • URL에서 분석을 위한 비디오 파일을 추가합니다. 비디오 파일을 참조하는 vj:// URI를 반환합니다.
• 비디오정글 프로젝트 만들기
  • 비디오 편집 생성을 위한 생성 스크립트, 분석된 비디오 및 이미지를 포함하는 비디오 정글 프로젝트를 생성합니다.
• 로컬로 편집
  • OpenTimelineIO 프로젝트를 만들고 Davinci Resolve Studio 인스턴스에서 열 수 있도록 컴퓨터에 다운로드합니다(이 도구를 호출하기 전에 Resolve Studio가 이미 실행 중이 어야 합니다 .)
• 비디오에서 생성-편집
  • 비디오 파일 세트에서 렌더링된 비디오 편집을 생성합니다.
• 단일 비디오에서 생성-편집
  • 단일 입력 비디오 파일에서 편집 생성
• 프로젝트 자산 가져오기
  • 비디오 편집 생성을 위해 프로젝트 내에서 에셋을 가져옵니다.
• 비디오 검색
  • 임베딩 및 키워드를 기반으로 비디오 일치 항목을 반환합니다.
• 업데이트-비디오-편집
  • 비디오 편집 정보를 실시간으로 업데이트합니다. Video Jungle이 열려 있으면 편집 내용이 실시간으로 업데이트됩니다.

실제 도구 사용

도구를 사용하려면 Video Jungle에 가입하고 API 키를 추가해야 합니다.

비디오 추가

다음은 add-video 도구를 호출하기 위한 프롬프트의 예입니다.

지엑스피1

URL에서 비디오를 다운로드하여 라이브러리에 추가하고, 나중에 검색할 수 있도록 분석합니다. 분석은 다중 모드이므로 오디오 및 시각적 구성 요소 모두에 대해 쿼리할 수 있습니다.

비디오 검색

비디오를 다운로드하고 분석한 후에는 search-videos 도구를 사용하여 해당 비디오에 대한 쿼리를 수행할 수 있습니다.

검색 결과에는 초기 분석에서 발견된 세부 정보에 따라 비디오 편집을 생성하는 데 필요한 관련 메타데이터가 포함되어 있습니다.

지역 비디오 검색

이 도구를 사용하려면 환경 변수 LOAD_PHOTOS_DB=1 설정해야 합니다. 이렇게 하면 Claude가 로컬 컴퓨터의 파일에 액세스할지 묻습니다.

이 작업이 완료되면 Apple 태그를 사용하여 휴대폰에 있는 비디오를 사진 앱에서 검색할 수 있습니다.

제 경우, "스케이트보드"를 검색하면 1,903개의 비디오 파일이 나옵니다.

비디오에서 생성-편집

마지막으로, 다음 검색 결과를 사용하여 편집 내용을 생성할 수 있습니다.

(현재) 비디오 편집 도구는 현재 채팅 내의 맥락에 의존합니다.

단일 비디오에서 생성-편집

마지막으로, 단일 기존 비디오에서 편집 내용을 줄일 수 있습니다.

구성

Video Jungle 설정 에 로그인하여 API 키를 받으세요. 그런 다음, 이 키를 사용하여 Video Jungle MCP를 시작하세요.

MacOS에서 이 MCP 서버가 사진 앱을 검색하도록 허용하려면:

빠른 시작

설치하다

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 비디오 편집기를 자동으로 설치하려면:

클로드 데스크탑

claude_desktop_config.json 수동으로 조정해야 합니다.

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

로컬 사진 앱 액세스가 활성화된 경우(사진 앱 검색):

디렉토리를 컴퓨터 에 저장소를 둔 디렉토리로 바꿔야 합니다.

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

2. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN
• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

( YOURDIRECTORY 와 YOURAPIKEY 이 저장소가 있는 디렉토리로 바꾸고, 설정 페이지에서 찾을 수 있는 Video Jungle API 키로 바꿔야 합니다.)

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

또한, 프로젝트 디렉터리의 app.log 에 로깅을 추가했습니다. API 호출을 진단하기 위한 로깅은 다음과 같이 추가할 수 있습니다.

프로젝트 작업을 진행하면서 따라갈 수 있는 합리적인 방법은 터미널 세션을 열고 다음을 실행하는 것입니다.