FFmpeg-MCP Server

by video-creator
Verified

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
find_video_path
可以查找视频文件路径,查找文件路径,递归查找精确匹配文件名的视频文件路径(支持带或不带扩展名) 参数: root_path - 要搜索的根目录 video_name - 视频文件名(可以带扩展名,但会忽略扩展名匹配) 返回: 首个匹配的视频文件完整路径,找不到时返回空字符串
clip_video
智能视频剪辑函数 参数: video_path : str - 源视频文件路径 start : int/float/str - 开始时间(支持秒数、MM:SS、HH:MM:SS格式,默认为视频开头,如果不传该参数,或者该参数为负数,从视频结尾往前剪辑) end : int/float/str - 结束时间(同上,默认为视频结尾) duration: int/float/str - 裁剪时长,end和duration必须有一个 output_path: str - 裁剪后视频输出路径,如果不传入,会有一个默认的输出路径 time_out: int - 命令行执行超时时间,默认为300s 返回: error - 错误码 str - ffmpeg执行过程中所有日志 str - 生成的剪辑文件路径 示例: clip_video("input.mp4", "00:01:30", "02:30")
concat_videos
使用FFmpeg拼接多个视频文件 参数: input_files (List[str]): 输入视频文件路径列表 output_path (str): 合并后的输出文件路径,如果不传入,会一个默认的输出路径 fast (bool): 拼接方法,可选值:"True"(默认,要求所有视频必须具有相同的编码格式、分辨率、帧率等参数)| "False(当不确定合并的视频编码格式、分辨率、帧率等参数是否相同的情况下,这个参数应该是False)" 返回: 执行日志 注意: 1. 当fast=True时,要求所有视频必须具有相同的编码格式、分辨率、帧率等参数 2. 推荐视频文件使用相同编码参数,避免拼接失败 3. 输出文件格式由output_path后缀决定(如.mp4/.mkv)
get_video_info
获取视频信息,包括时长,帧率,codec等 参数: video_path (str): 输入视频文件路径 返回: 视频详细信息
play_video
使用 ffplay 播放视频文件,支持mkv,mp4,mov,avi,3gp等等 参数: video_path(str) - 视频文件的路径。 speed(float) - 浮点型,播放速率,建议0.5-2之间。 loop(int) - 整形,是否循环播放,1:不循环,播放后就退出,0: 循环播放。
overlay_video
两个视频叠加,注意不是拼接长度,而是画中画效果 参数: background_video(str) - 背景视频文件的路径。 overlay_video(str) - 前景视频文件路径。 output_path(str) - 输出路径 position(enum) - 相对位置,TopLeft=1: 左上角,TopCenter=2: 上居中, TopRight=3: 右上角 RightCenter=4: 右居中 BottomRight=5: 右下角 BottomCenter=6: 下居中 BottomLeft=7: 左下角 LeftCenter=8: 左居中 Center=9: 居中 dx(int) - 整形,前景视频坐标x偏移值 dy(int) - 整形,前景视频坐标y偏移值
scale_video
视频缩放 参数: width(int) - 目标宽度。 height(int) - 目标高度。 output_path(str) - 输出路径
ID: 2zxiyezqfc