ffmpeg-skill-rs (fms)
ffmpeg-skill-rs 是 kajisho5/ffmpeg-skill 的高效能原生 Rust 移植與分支版本。它以單一獨立的靜態連結原生二進位檔案取代了脆弱的 shell/Python 包裝腳本,提供嚴格的型別安全、次毫秒級的呼叫延遲,以及內建的模型上下文協定(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
模型上下文協定(MCP)配置
將 ffmpeg-skill 加入您的 MCP 用戶端設定檔(例如 claude_desktop_config.json、gemini 或 cursor):
{
"mcpServers": {
"ffmpeg-skill": {
"command": "ffmpeg-skill",
"args": ["mcp"]
}
}
}