Hosting

Local Python MCP server

Transport

stdio

Endpoint

Local process; no hosted endpoint documented

Authentication

No account or API key is documented for local FFmpeg operations.

Requirements

• macOS on ARM64 or x86_64 according to the maintainer README.
• uv and FFmpeg for the documented installation.
• A local media file; no YouTube URL acquisition is documented.

Setup steps

1. On macOS, clone the repository and run `uv sync`.
2. Configure an MCP client to run `uv --directory <absolute repository path> run ffmpeg-mcp` over stdio.
3. Pass an absolute local video path to `get_video_info` or `extract_frames_from_video`.

Eight stored tools retained as matching the repository tool list.

• find_video_path

  Find a video file recursively by name.

  Parameters: directory, file name
  01
• get_video_info

  Read duration, frame rate, codec, width, and height.

  Parameters: video_path
  02
• clip_video

  Trim a video by start and end or duration.

  Parameters: video_path, start_time, end_time or duration
  03
• concat_videos

  Combine video files into one output.

  Parameters: video files, output_path
  04
• play_video

  Play local video or audio with ffplay.

  Parameters: video_path, speed (optional), loop (optional)
  05
• overlay_video

  Overlay one video on another.

  Parameters: background_video, overlay_video, output_path, position, dx, dy
  06
• scale_video

  Scale a video to requested dimensions.

  Parameters: video_path, width, height, output_path
  07
• extract_frames_from_video

  Save frames from local video at a requested interval and count.

  Parameters: video_path, fps, output_folder, format, total_frames
  08

• The maintainer README says the current supported platforms are macOS only; this is not a tested Windows recommendation.
• The server does not fetch YouTube URLs or transcribe speech.
• Playback starts a local player and is not itself an agent-readable audio analysis.

• maintainer repository readme

  Documents eight tools, uv setup, and macOS-only support.

• creator github avatar

  Local copy decoded as a 420 by 420 PNG and visually reviewed.

• maintainer repository documentation

  Maintainer repository describes local video search, editing, stitching, playback and related FFmpeg operations; stored eight tools retained from repo tool listing.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.