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"]
}
}
}