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：兩個視頻疊加。
  • 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。