Video Editor MCP Server

비디오 편집기 MCP 서버

자연어 명령을 통해 비디오 편집 작업을 수행하기 위해 FFmpeg를 활용하는 강력한 비디오 편집 MCP 서버입니다.

구성 요소

도구

서버는 하나의 주요 도구를 구현합니다.

• execute_ffmpeg : 진행률 추적을 통해 FFmpeg 명령을 실행합니다.
  • 명령 문자열을 입력으로 받습니다.
  • FFmpeg 작업을 검증하고 실행합니다.
  • 처리 중 실시간 진행 상황을 보고합니다.
  • 오류를 처리하고 자세한 피드백을 제공합니다.
  • 다음을 포함한 모든 FFmpeg 작업을 지원합니다.
    • 트리밍/절단
    • 비디오 병합
    • 형식 변환
    • 속도 조정
    • 오디오 트랙 추가
    • 오디오 추출
    • 자막 추가
    • 기본 필터(밝기, 대비 등)

구성

필수 조건

1. FFmpeg는 시스템 PATH에 설치되어 접근 가능해야 합니다.
2. 파이썬 3.9 이상
3. 필요한 Python 패키지:지엑스피1

설치

1. FFmpeg가 아직 설치되지 않았다면 설치하세요:
   # On macOS with Homebrew brew install ffmpeg # On Windows with Chocolatey choco install ffmpeg # On Ubuntu/Debian sudo apt install ffmpeg
2. 비디오 편집기 패키지를 설치하세요:
   uv add video-editor

Claude 데스크톱 통합

Claude Desktop 구성 파일에서 다음을 구성합니다.

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

개발

건축 및 출판

1. 동기화 종속성:
   uv sync
2. 패키지 빌드:
   uv build
3. PyPI에 게시:
   uv publish

참고: 다음을 통해 PyPI 자격 증명을 설정하세요.

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

디버깅

최상의 디버깅 환경을 위해 MCP Inspector를 사용하세요.

사용 예

Claude Desktop에 연결하면 다음과 같은 자연어 요청을 할 수 있습니다.

1. "1:30에서 2:45까지 비디오.mp4를 잘라냅니다."
2. "input.mp4를 WebM 포맷으로 변환"
3. "video.mp4를 2배 빠르게 재생"
4. "video1.mp4와 video2.mp4를 병합합니다"
5. "video.mp4에서 오디오 추출"
6. "video.mp4에 subtitles.srt를 추가합니다"

서버는 다음을 수행합니다.

1. 귀하의 요청을 구문 분석하세요
2. 적절한 FFmpeg 명령을 생성합니다
3. 진행 상황 추적을 통해 실행하세요
4. 완료 시 피드백 제공

오류 처리

서버에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

• 잘못된 입력 파일
• 잘못된 FFmpeg 명령
• 런타임 실행 오류
• 진행 상황 추적 문제

모든 오류는 디버깅을 위한 자세한 메시지와 함께 클라이언트에게 보고됩니다.

보안 고려 사항

• 명시적으로 허용된 디렉토리의 파일만 처리합니다.
• 실행 전에 FFmpeg 명령을 검증합니다.
• 모든 입력 매개변수를 정리합니다.
• 보안 관련 문제에 대한 자세한 오류 메시지를 보고합니다.

기여하다

여러분의 참여를 환영합니다! 다음 단계를 따라주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성하세요
3. 변경 사항을 만드세요
4. 풀 리퀘스트 제출