Communitygithub.com

bhubbard/ffmpeg-skill-rs

高性能ネイティブRustフォーク版ffmpeg-skill。決定論的FFmpegメディア操作ツールキット兼Model Context Protocol(MCP)サーバーで、AIペアプログラマーやクリエイター向け。

ffmpeg-skill-rs とは?

`ffmpeg-skill-rs`は、もともとPython/シェルスクリプトベースだった`ffmpeg-skill`をRustで完全に再実装した高性能ネイティブフォークです。単一のスタンドアロンバイナリとして動作し、PythonやNode.jsなどのランタイム依存が一切不要。サブミリ秒の起動レイテンシと厳格な型安全性を備え、AIエージェントと統合するためのModel Context Protocol(MCP)JSON-RPC 2.0サーバーを内蔵しています。対応プラットフォームはClaude Desktop、Cursor、Antigravity、Open WebUIなど多数。動画のトリミング、アスペクト比変換、クロップ、ブラックバー検出、クロスフェード結合、ラウドネス正規化(EBU R128)、無音除去、スピードランプ、波形レンダリング、シーン検出、配信前チェックなど、多彩なメディア操作を決定論的なJSONコントラクトに基づいて実行できます。Apple Silicon VideoToolbox、NVIDIA NVENC、VAAPIなどのハードウェアアクセラレーションも自動検出・活用します。

対応✓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を自動活用。
  • スマートジャンプカット & 2パス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 2パスラウドネス正規化
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"]
    }
  }
}

関連スキル