hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides access to videos stored in the macOS Photos app when enabled with the LOAD_PHOTOS_DB environment variable
Allows downloading videos from YouTube URLs to add to the user's video library

비디오 편집기 MCP 서버

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

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

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

구성 요소

자원

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

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

프롬프트

곧 출시됩니다.

도구

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

add-video: URL에서 비디오 추가
- 비디오 파일을 참조하는 vj:// URI를 반환합니다.
search-videos: 임베딩을 사용하여 비디오 검색
- 임베딩 및 키워드를 기반으로 비디오 일치 항목을 반환합니다.
비디오에서 생성-편집
- 비디오 파일 세트에서 렌더링된 비디오 편집을 생성합니다.
단일 비디오에서 생성-편집
- 단일 입력 비디오 파일에서 편집 생성

실제 도구 사용

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

비디오 추가

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

지엑스피1

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

비디오 검색

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

can you search my videos for fly traps?

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

지역 비디오 검색

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

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

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

can you search my local video files for Skateboard?

비디오에서 생성-편집

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

can you create an edit of all the times the video says "fly trap"?

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

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

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

can you create an edit of all the times this video says the word "fly trap"?

구성

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

$ uv run video-editor-mcp YOURAPIKEY

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

$ LOAD_PHOTOS_DB=1 uv run video-editor-mcp YOURAPIKEY

빠른 시작

설치하다

Smithery를 통해 설치

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

npx -y @smithery/cli install video-editor-mcp --client claude

클로드 데스크탑

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

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

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uvx",
     "args": [
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uv",
     "args": [
       "--directory",
       "/Users/YOURDIRECTORY/video-editor-mcp",
       "run",
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

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

  "video-jungle-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<PATH_TO>/video-jungle-mcp",
      "run",
      "video-editor-mcp",
      "<YOURAPIKEY>"
    ],
   "env": {
        "LOAD_PHOTOS_DB": "1"
    }
  },

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

개발

건축 및 출판

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

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

uv sync

패키지 배포 빌드:

uv build

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

PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 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 키로 바꿔야 합니다.)

npx @modelcontextprotocol/inspector uv run --directory /Users/YOURDIRECTORY/video-editor-mcp video-editor-mcp YOURAPIKEY

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

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

logging.info("this is a test log")

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

$ tail -n 90 -f app.log

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

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

video-editing-mcp