Skip to main content

使用ffmpeg,对视频进行裁剪,拼接,滤镜等操作

Project description

FFmpeg-MCP

Using ffmpeg command line to achieve an mcp server, can be very convenient, through the dialogue to achieve the local video search, tailoring, stitching, playback and other functions

FFmpeg-Server MCP server

Support Tools

The server implements the following tools:

  • find_video_path The parameters are directory and file name, file name can be complete, or is not suffixed, recursive search in the directory, return the full path
  • get_video_info The parameters are video path, return the video info, linkes duration/fps/codec/width/height.
  • clip_video The parameter is the file path, start time, end time or duration, and returns the trimmed file path
  • concat_videos The parameters are the list of files, the output path, and if the video elements in the list of files, such as width, height, frame rate, etc., are consistent, quick mode synthesis is automatically used
  • play_video Play video/audio with ffplay, support many format, like mov/mp4/avi/mkv/3gp, video_path: video path speed: play rate loop: play count
  • overlay_video Two video overlay.
    background_video: backgroud video path
    overlay_video: front video path
    output_path: output video path
    position: relative location
    dx: x offset
    dy: y offset
  • scale_video Video scale.
    video_path: in video path
    width: out video width, -2 keep aspect
    height: out video height, -2 keep aspect
    output_path: output video path
  • extract_frames_from_video Extract images from a video.
    Parameters:
    video_path (str): The path to the video.
    fps (int): Extract one frame every specified number of seconds. If set to 0, extract all frames; if set to 1, extract one frame per second.
    output_folder (str): The directory where the images will be saved.
    format (int): The format of the extracted images; 0: PNG, 1: JPG, 2: WEBP.
    total_frames (int): The maximum number of frames to extract. If set to 0, there is no limit

More features are coming

Installation procedure

  1. Download project
git clone  https://github.com/video-creator/ffmpeg-mcp.git
cd ffmpeg-mcp
uv sync
  1. Configuration in Cline
{
  "mcpServers": {
    "ffmpeg-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "--directory",
        "/Users/xxx/Downloads/ffmpeg-mcp",
        "run",
        "ffmpeg-mcp"
      ],
      "transportType": "stdio"
    }
  }
}

Note: the value:/Users/XXX/Downloads/ffmpeg in args need to replace the actual download ffmpeg-mcp directory

Supported platforms

Currently, only macos platforms are supported, including ARM64 or x86_64

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_ffmpeg_mcp-0.1.4.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_ffmpeg_mcp-0.1.4-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_ffmpeg_mcp-0.1.4.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_ffmpeg_mcp-0.1.4.tar.gz
Algorithm Hash digest
SHA256 2651d85e0f654951abe69cd1b0f9c3347d19f31ce5be9e63adfd02fca0a55fe4
MD5 47598dd9731f748c64d39d4c0a8fdd31
BLAKE2b-256 1e4837f60d5488d16b518ac88fc6e1da95d7590f0b3560c7b14d350c181ad06f

See more details on using hashes here.

File details

Details for the file iflow_mcp_ffmpeg_mcp-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_ffmpeg_mcp-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 209b7c9b2761bbaa6bb144cf7a5286e99993edd275632971c37e1c90c8104666
MD5 574de352724fb317396c55330b2c1f4a
BLAKE2b-256 10318c248671fe8ba0caa29c8b029835b3f28e949541bce4f5f3a38668caece8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page