Video & Audio Editing MCP Server

Instructions

Implementation Reference

• server.py:413-425 (handler)

  The handler function that executes the set_video_frame_rate tool logic, using ffmpeg to set the video frame rate while attempting to copy the audio stream, with a fallback to re-encoding if necessary.

  @mcp.tool()
  def set_video_frame_rate(input_video_path: str, output_video_path: str, frame_rate: int) -> str:
      """Sets the frame rate of a video, attempting to copy the audio stream.
      Args:
          input_video_path: Path to the source video file.
          output_video_path: Path to save the video with the new frame rate.
          frame_rate: Target video frame rate (e.g., 24, 30, 60).
      Returns:
          A status message indicating success or failure.
      """
      primary_kwargs = {'r': frame_rate, 'acodec': 'copy'}
      fallback_kwargs = {'r': frame_rate} # Re-encode audio
      return _run_ffmpeg_with_fallback(input_video_path, output_video_path, primary_kwargs, fallback_kwargs)

• server.py:332-349 (helper)

  Supporting helper utility function used by the set_video_frame_rate handler (and other similar tools) to execute ffmpeg operations with a primary set of parameters and a fallback set.

  def _run_ffmpeg_with_fallback(input_path: str, output_path: str, primary_kwargs: dict, fallback_kwargs: dict) -> str:
      """Helper to run ffmpeg command with primary kwargs, falling back to other kwargs on ffmpeg.Error."""
      try:
          ffmpeg.input(input_path).output(output_path, **primary_kwargs).run(capture_stdout=True, capture_stderr=True)
          return f"Operation successful (primary method) and saved to {output_path}"
      except ffmpeg.Error as e_primary:
          try:
              ffmpeg.input(input_path).output(output_path, **fallback_kwargs).run(capture_stdout=True, capture_stderr=True)
              return f"Operation successful (fallback method) and saved to {output_path}"
          except ffmpeg.Error as e_fallback:
              err_primary_msg = e_primary.stderr.decode('utf8') if e_primary.stderr else str(e_primary)
              err_fallback_msg = e_fallback.stderr.decode('utf8') if e_fallback.stderr else str(e_fallback)
              return f"Error. Primary method failed: {err_primary_msg}. Fallback method also failed: {err_fallback_msg}"
      except FileNotFoundError:
          return f"Error: Input file not found at {input_path}"
      except Exception as e:
          return f"An unexpected error occurred: {str(e)}"