video-editor-mcp

Claude에게 포괄적인 대화형 비디오 편집 도구 키트를 제공하는 MCP(Model Context Protocol) 서버입니다 — 트리밍, 크롭, 컬러 그레이딩, 자막, 비트 싱크, 안정화 등 — ffmpeg, faster-whisper, yt-dlp를 기반으로 하며, 선택적으로 DaVinci Resolve 및 CapCut 통합을 지원합니다.

원하는 편집을 채팅으로 설명하면 Claude가 도구를 호출해 처리합니다.

도구

Related MCP server: Video MCP

설정

1. 클론 및 Python 의존성 설치

git clone https://github.com/dr-ashraf-s-MCP-LABS/video-editor-mcp.git
cd video-editor-mcp
pip install -r requirements.txt

또한 PATH에 ffmpeg가 필요하며(또는 서버가 자동으로 대체 사용하는 imageio-ffmpeg) yt-dlp도 필요합니다.

2. 구성 (선택 사항)

.env.example을 .env로 복사하고, 기본이 아닌 바이너리 위치가 필요하거나, 자신의 CapCut/DaVinci 설치를 지정하려 하거나, Instagram/Facebook 다운로드를 위한 cookies.txt가 필요하면 조정하세요(브라우저 확장 프로그램(예: "Get cookies.txt LOCALLY")으로 내보낼 수 있습니다).

3. Claude에 등록

Claude Desktop / Claude Code MCP 구성에 추가하세요:

{
  "mcpServers": {
    "video-editor": {
      "command": "python",
      "args": ["/absolute/path/to/video-editor-mcp/server.py"]
    }
  }
}

Claude를 다시 시작하고 대화형으로 편집을 시작하세요. 예: "이 릴을 다운로드하고, 내 원본 푸티지에 스타일을 맞추고, 이 음악을 추가하고, 자막을 넣어줘."

참고

• download_video, output, 그리고 다운로드된 파일은 기본적으로 server.py 옆의 ./downloads와 ./output에 저장됩니다 — VIDEO_EDITOR_DOWNLOADS_DIR / VIDEO_EDITOR_OUTPUT_DIR로 재정의하세요.

• CapCut 및 DaVinci Resolve 도구는 관련 환경 변수를 설정하지 않았거나 해당 앱이 없으면 "not installed"라고 보고하며 정상적으로 처리됩니다.

• auto_captions 및 batch_process의 자막 모드는 첫 사용 시 Whisper base 모델(~150MB)을 다운로드합니다.

라이선스

MIT — LICENSE를 참조하세요.