Communitygithub.com

bhubbard/ffmpeg-skill-rs

FFmpeg 미디어 조작을 위한 고성능 네이티브 Rust 도구이자 AI 페어 프로그래머 및 크리에이터를 위한 Model Context Protocol (MCP) 서버입니다. 결정론적이며 셸/Python 의존성이 없습니다.

ffmpeg-skill-rs란 무엇인가요?

`ffmpeg-skill-rs`는 원래 `kajisho5/ffmpeg-skill`의 고성능 네이티브 Rust 포크로, Python이나 Node.js 같은 외부 런타임 없이 단일 정적 바이너리로 동작합니다. 이 도구는 엄격한 타입 안전성과 서브 밀리초 단위의 호출 지연 시간을 제공하며, JSON-RPC 2.0 표준을 따르는 내장 MCP 서버를 통해 Claude Desktop, Cursor, Antigravity, Open WebUI 등 다양한 AI 에이전트와 직접 통합될 수 있습니다. 기능적으로는 하드웨어 가속(Apple Silicon VideoToolbox, Nvidia NVENC, VAAPI)을 자동으로 활용하고, EBU R128 기반의 방송급 오디오 라우드니스 노멀라이제이션, 스마트 점프 컷(묵음 구간 제거), 씬 전환 탐지, 해상도 및 비율 변환, 플랫폼별 내보내기(YouTube, Reels, TikTok, ProRes, GIF) 등 거의 모든 미디어 처리 작업을 결정론적이고 기계가 읽기 쉬운 JSON 계약(`contract_version: "1.0"`) 하에 수행합니다. CLI 도구(`fms` 또는 `ffmpeg-skill`)로도 사용 가능하며, MCP 설정을 통해 AI 에이전트가 파일 경로나 매개변수 추측 없이 정확한 미디어 작업을 실행할 수 있도록 돕습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add bhubbard/ffmpeg-skill-rs

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ffmpeg-skill-rs (fms)

ffmpeg-skill-rs는 kajisho5/ffmpeg-skill의 고성능 네이티브 Rust 포트이자 포크입니다. 취약한 셸/Python 래퍼 스크립트를 단일 독립 실행형 정적 링크 네이티브 바이너리로 대체하여 엄격한 타입 안전성, 서브 밀리초 호출 지연 시간, 그리고 내장된 Model Context Protocol (MCP) JSON-RPC 2.0 stdio 서버를 제공합니다.

주요 특징

  • 제로 런타임 오버헤드: 단일 컴파일된 네이티브 Rust 바이너리 (ffmpeg-skill / 별칭 fms). Python, Node.js, pip 환경이 필요하지 않습니다.
  • 내장 MCP 서버: Claude Desktop, Cursor, Antigravity, Open WebUI 및 기타 AI 에이전트와 즉시 통합 (fms mcp).
  • 결정론적 기계 판독 가능 계약: 자율 코딩 에이전트의 안정적인 도구 실행을 위해 contract_version: "1.0" JSON 명세를 출력합니다.
  • 하드웨어 가속 프리셋: Apple Silicon VideoToolbox (h264_videotoolbox, hevc_videotoolbox, prores_videotoolbox), Nvidia NVENC, VAAPI를 자동으로 활용합니다.
  • 스마트 점프 컷 및 투패스 EBU R128: 끊김 없는 무음 구간 제거와 방송급 오디오 라우드니스 노멀라이제이션을 제공합니다.

CLI 사용법

# 기능 및 하드웨어 가속 검사
fms doctor

# 점 표기법 필드 선택기를 사용한 심층 미디어 프로빙
fms probe input.mp4 --compact
fms probe input.mp4 --field "duration"
fms probe input.mp4 --field "video[0].codec"

# 무손실 또는 프레임 정밀 트리밍
fms cut input.mp4 --start 00:01:30 --duration 15.5
fms cut input.mp4 --start 10.0 --end 25.0 --accurate -o output.mp4

# 종횡비 변환 (패딩, 크롭, 블러)
fms fit input.mp4 -a 9:16 -m pad --fps 60

# 정확한 직사각형 경계 상자 크롭
fms crop input.mp4 -W 1080 -H 1080 -x 420 -y 0

# 블랙바 / 레터박스 감지
fms cropdetect movie.mp4 --limit 30 --json

# 플랫폼 전달 프리셋 (YouTube, Reels, TikTok, ProRes, GIF)
fms export input.mov --preset reels
fms export input.mov --preset youtube4k
fms export clip.mp4 --preset gif --fps 15

# 크로스페이드 전환과 함께 연결
fms join clip1.mp4 clip2.mp4 clip3.mp4 --transition dissolve --transition-duration 1.0

# EBU R128 투패스 라우드니스 노멀라이제이션
fms loudness podcast.wav --preset podcast -o podcast_master.wav

# 점프 컷 무음 구간 제거
fms silence raw_take.mp4 --noise-db -28 --min-duration 0.4 --remove

# atempo 피치 보존 속도 조작
fms speedramp video.mp4 --speed 1.5

# 시각적 파형 및 스펙트로그램 렌더링
fms waveform audio.mp3 --mode waveform -W 1920 -H 400 -o waveform.png

# 씬 전환 감지 및 썸네일 추출
fms scenes video.mp4 --threshold 0.35 -d ./thumbnails

# 전달 전 사양 준수 검증기
fms check final_cut.mp4 --platform reels --json

# 기계 판독 가능 계약 JSON 출력
fms contract --json

Model Context Protocol (MCP) 설정

MCP 클라이언트 설정 (예: claude_desktop_config.json, gemini, 또는 cursor)에 ffmpeg-skill을 추가하세요:

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "ffmpeg-skill",
      "args": ["mcp"]
    }
  }
}

관련 스킬