FFmpeg-MCP Server

Instructions

使用 ffplay 播放视频文件，支持mkv,mp4,mov,avi,3gp等等

参数：
video_path(str) - 视频文件的路径。
speed(float) - 浮点型,播放速率,建议0.5-2之间。
loop(int) - 整形,是否循环播放,1:不循环,播放后就退出,0: 循环播放。

Implementation Reference

• src/ffmpeg_mcp/server.py:94-104 (handler)

  MCP tool handler for 'play_video', registered via @mcp.tool() decorator. Delegates execution to cut_video.video_play with parameters.

  @mcp.tool()
  def play_video(video_path, speed = 1, loop = 1):
      """
      使用 ffplay 播放视频文件，支持mkv,mp4,mov,avi,3gp等等
  
      参数：
      video_path(str) - 视频文件的路径。
      speed(float) - 浮点型,播放速率,建议0.5-2之间。
      loop(int) - 整形,是否循环播放,1:不循环,播放后就退出,0: 循环播放。
      """
      return cut_video.video_play(video_path,speed=speed,loop=loop)

• src/ffmpeg_mcp/cut_video.py:161-177 (helper)

  Core helper function implementing video playback logic using ffplay. Constructs FFplay command with speed adjustment via filters and loop option.

  def video_play(video_path: str, speed, loop):
      speed = float(speed)
      loop = int(loop)
      cmd = f" -loop {loop} "
      if loop != 0:
          cmd = f" {cmd} -autoexit"
      audio_filter_str = ""
      video_filter_str = ""
      if (speed != 1):
          fmt_ctx = ffmpeg.media_format_ctx(video_path)
          if len(fmt_ctx.audio_streams) > 0:
              audio_filter_str = f"-af atempo={speed}"
          if len(fmt_ctx.video_streams) > 0:
              video_filter_str = f"-vf setpts={1/speed}*PTS"
      cmd = f" {cmd } {audio_filter_str} {video_filter_str}   -i {video_path}"
      print(cmd)
      return ffmpeg.run_ffplay(cmd, timeout=60)