Ffmpeg MCP

🚀 FFmpeg-MCP

FFmpegのコマンドラインを使用することで、mcpサーバーを簡単に実装できます。ダイアログを通じて、ローカルビデオの検索、クリッピング、結合、再生などの機能を提供します。

🚀 クイックスタート

FFmpeg-MCPを使用することで、ffmpegのコマンドラインを利用してmcpサーバーを簡単に構築でき、ローカルビデオに対する様々な操作が可能になります。

✨ 主な機能

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

• find_video_path
  パラメータはディレクトリとファイル名です。ファイル名は完全な名前または拡張子を含まない名前でも構いません。ディレクトリを再帰的に検索し、完全なパスを返します。
• get_video_info
  パラメータはビデオのパスで、ビデオの情報（再生時間、フレームレート、エンコーダ、幅、高さなど）を返します。
• clip_video
  パラメータはファイルパス、開始時間、終了時間、および持続時間で、クリッピング後のファイルパスを返します。
• concat_videos
  パラメータはファイルリストと出力パスです。ファイルリスト内のビデオ要素（アスペクト比、フレームレートなど）が一致する場合、自動的に高速モードで合成されます。
• play_video
  ffplayを使用してビデオ/オーディオを再生します。mov/mp4/avi/mkv/3gpなどの複数の形式をサポートします。パラメータにはビデオパス、再生速度、およびループ回数が含まれます。
• overlay_video
  2つのビデオを重ね合わせます。
  • background_video: 背景ビデオのパス
  • overlay_video: 前景ビデオのパス
  • output_path: 出力ビデオのパス
  • position: 相対位置
  • dx: x軸のオフセット
  • dy: y軸のオフセット
• scale_video
  ビデオをスケーリングします。
  • video_path: 入力ビデオのパス
  • width: 出力ビデオの幅。-2はアスペクト比を維持することを意味します。
  • height: 出力ビデオの高さ。-2はアスペクト比を維持することを意味します。
  • output_path: 出力ビデオのパス

さらなる機能は開発中です。

📦 インストール

1. プロジェクトのダウンロード

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

2. コマンドラインの設定

{
  "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）のみをサポートしています。