FFmpeg-MCP

FFmpeg-MCP

ffmpeg のコマンドラインを使用して MCP サーバーを実現します。対話を通じて、ローカル動画の検索、トリミング、結合、再生などの機能を簡単に利用できます。

サポートするツール

このサーバーは以下のツールを実装しています。

• find_video_path ディレクトリとファイル名を指定します。ファイル名は完全な名前でも、拡張子を省略した名前でも指定できます。ディレクトリを再帰的に検索し、フルパスを返します。
• get_video_info 動画のパスを指定すると、再生時間、FPS、コーデック、幅、高さなどの動画情報を返します。
• clip_video ファイルパス、開始時刻、終了時刻または再生時間を指定すると、トリミング後のファイルパスを返します。
• concat_videos ファイルのリストと出力パスを指定します。リスト内の動画の幅、高さ、フレームレートなどが一致している場合は、高速モードで自動的に結合します。
• play_video ffplay で動画／音声を再生します。mov／mp4／avi／mkv／3gp など、多くの形式に対応しています。video_path：動画のパス、speed：再生速度、loop：再生回数
• overlay_video 2 つの動画を重ね合わせます。
  background_video：背景動画のパス
  overlay_video：前面に重ねる動画のパス
  output_path：出力動画のパス
  position：相対位置
  dx：x 軸方向のオフセット
  dy：y 軸方向のオフセット
  
• scale_video 動画を拡大縮小します。
  video_path：入力動画のパス
  width：出力動画の幅。-2 の場合はアスペクト比を維持します
  height：出力動画の高さ。-2 の場合はアスペクト比を維持します
  output_path：出力動画のパス
  
• extract_frames_from_video 動画から画像を抽出します。
  パラメーター：
  video_path (str)：動画のパス。
  fps (int)：指定した秒数ごとに 1 フレームを抽出します。0 に設定するとすべてのフレームを抽出し、1 に設定すると 1 秒ごとに 1 フレームを抽出します。
  output_folder (str)：画像の保存先ディレクトリ。
  format (int)：抽出する画像の形式。0：PNG、1：JPG、2：WEBP。
  total_frames (int)：抽出するフレームの最大数。0 に設定すると、上限はありません。
  
  

今後、さらに機能を追加する予定です。

インストール手順

1. プロジェクトをダウンロードします

git clone  https://github.com/video-creator/ffmpeg-mcp.git
cd ffmpeg-mcp
uv sync

2. Cline で設定します

{
  "mcpServers": {
    "ffmpeg-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "--directory",
        "/Users/xxx/Downloads/ffmpeg-mcp",
        "run",
        "ffmpeg-mcp"
      ],
      "transportType": "stdio"
    }
  }
}

注：args 内の値:/Users/XXX/Downloads/ffmpeg は、実際にダウンロードした ffmpeg-mcp ディレクトリに置き換えてください。

対応プラットフォーム

現在は macOS プラットフォームのみ対応しており、ARM64 または x86_64 を利用できます。