Communitygithub.com

bhubbard/ffmpeg-skill-rs

高性能原生 Rust 版 ffmpeg-skill 复刻。确定性 FFmpeg 媒体操作工具包及模型上下文协议(MCP)服务器,专为 AI 结对编程者和创作者设计。

ffmpeg-skill-rs 是什么?

`ffmpeg-skill-rs` 是 `kajisho5/ffmpeg-skill` 的高性能原生 Rust 移植与复刻版本。它将脆弱的 shell/Python 包装脚本替换为单一独立、可静态链接的原生二进制文件,提供严格的类型安全、亚毫秒级调用延迟以及内置的模型上下文协议(MCP)JSON-RPC 2.0 stdio 服务器。该工具支持零运行时开销(无需 Python、Node.js 或 pip)、硬件加速预设(Apple Silicon VideoToolbox、Nvidia NVENC、VAAPI)、智能跳切与 EBU R128 响度标准化、场景检测、缩略图提取以及交付规范合规性验证。通过 `fms mcp` 命令,可无缝集成 Claude Desktop、Cursor、Antigravity、Open WebUI 等 AI 代理,为媒体处理工作流提供确定性、可机器读取的 JSON 合约。

兼容平台✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add bhubbard/ffmpeg-skill-rs

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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

相关技能