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