AI导哈

FFmpeg媒体处理服务器

提供40多种高级FFmpeg工具，用于视频/音频处理、分析和流媒体服务。

  • by dubnium0
  • Python
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 dubnium0/ffmpeg-mcp

使用说明

FFmpeg MCP服务器

模型上下文协议（MCP）服务器，提供 40多种高级FFmpeg工具 用于视频/音频处理、分析和流媒体

特性

媒体分析与探究（7个工具）

  • get_media_info --全面的元数据（编解码器、比特率、分辨率、fps等）
  • get_video_resolution --宽度、高度、纵横比
  • get_duration --文件持续时间（秒）&格式化
  • list_streams --所有视频、音频、字幕流
  • get_frame_count --总帧数
  • 检测中心变更 --带有时间戳的场景剪切检测
  • 获取密钥帧 --关键帧时间戳列表

格式转换（5个工具）

  • 视频转换 --全编解码器/质量控制（x264、x265、VP9、AV1等）
  • 转换_音频 --音频格式转换（MP3、AAC、FLAC、WAV、OGG等）
  • convert_to_gif --具有调色板优化的高品质GIF
  • batch_convert --批量转换整个目录
  • 提取音频 --从视频中提取音轨

视频编辑（10个工具）

  • trim_video --按时间分段
  • 合并视频 --连接多个视频
  • resize_video --缩放到任何分辨率
  • 变速 --通过音频同步加速/减速
  • 提取帧 --将帧导出为图像
  • 创建_视频_图片 --图像序列→ video
  • rotate_video --90°、180°、270°或任意角度
  • crop_video --种植一个地区
  • generate_缩略图 --将帧提取为图像
  • add_thumbnail --将海报图像嵌入MP4

音频处理（7个工具）

  • adjust_体积 --音量控制（系数、dB、百分比）
  • 正常化_音频 --EBU R128响度归一化
  • 混音 --叠加/替换音轨
  • remove_audio --删除所有音频
  • add_fade_audio --淡入/淡出效果
  • 发电机波形 --音频波形可视化
  • 生成频谱图 --光谱图像生成

视觉效果和滤镜（7个工具）

  • add_text_overlay --带有位置、时间、样式的文本/水印
  • add_image_overlay --徽标/水印图像叠加
  • 应用程序_视频过滤器 --任何FFmpeg滤镜（模糊、锐化、等效、色调等）
  • add_fade --视频淡入/淡出
  • 图片_图片 --PiP效果与两个视频
  • 侧面_侧面 --水平/垂直分割视图
  • create_slideshow --带有过渡（淡入淡出、擦除、幻灯片）的图像幻灯片

字幕（3个工具）

  • extract_subtitles --提取字幕轨道（SRT、ASS、VTT）
  • burn_subtitles --将硬编码字幕转换为视频
  • add_subtitle_track --添加带有语言标签的软字幕

流媒体（4个工具）

  • create_hls_stream --生成HLS片段+播放列表
  • create_dash_stream --生成DASH清单+分段
  • create_adaptive_hls --多比特率自适应流媒体（1080p/720p/480p/360p）
  • stream_to_tmp --流式传输到YouTube直播、Twitch等。

高级加工（14种工具）

  • two_pass_encode --最佳比特率分布
  • 稳定视频 --减振（vidstab）
  • 降噪_视频 --降噪（hqdn3d，nlmeans）
  • 去隔行_视频 --交错→ 渐进式的
  • change_framerate --带运动插值的FPS转换
  • 压缩_视频 --目标文件大小或CRF压缩
  • 添加元数据 --添加/修改标签（标题、艺术家、年份等）
  • remove_元数据 --删除所有元数据
  • 反向视频 --反向播放视频
  • create_mosaic --视频网格布局（2x2、3x2等）
  • run_custom_ffmpeg --执行任何自定义FFmpeg命令
  • get_ffmpeg_version --FFmpeg版本信息
  • list_supportd_格式 --所有支持的格式
  • list_supported_codecs --所有支持的编解码器

先决条件

  • Python 3.10+
  • FFmpeg 已安装并可在PATH上使用
    • 窗户： winget install ffmpeg 或从以下网址下载https://ffmpeg.org/download.html
    • macOS： brew install ffmpeg
    • Linux： sudo apt install ffmpeg

安装

cd ffmpeg-mcp
pip install -r requirements.txt

用法

手动克劳德桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ffmpeg-mcp": {
      "command": "python",
      "args": ["C:/path/to/ffmpeg-mcp/server.py"]
    }
  }
}

项目结构

ffmpeg-mcp/
├── server.py           # MCP server entry point
├── utils.py            # Shared utilities (run_command, probe, validation)
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── README.md           # This file
└── tools/
    ├── __init__.py     # Tool registration
    ├── probe.py        # Media analysis & probing tools
    ├── convert.py      # Format conversion tools
    ├── video.py        # Video editing tools
    ├── audio.py        # Audio processing tools
    ├── effects.py      # Visual effects & filter tools
    ├── subtitles.py    # Subtitle management tools
    ├── streaming.py    # Streaming (HLS/DASH/RTMP) tools
    └── advanced.py     # Advanced processing tools

例子

分析视频

“获取有关此视频的详细信息：C:/Videos/test.mp4”

转换视频

“使用H.265编解码器以CRF 20质量将test.mp4转换为MKV”

创建Gif

“从5秒到15秒之间的视频创建一个320像素宽的GIF”

压缩视频

“将此视频压缩到50MB以下”

自适应流

创建具有1080p、720p和480p质量级别的HLS流

稳定抖动的视频

“稳定这个不稳定的视频”

许可证

麻省理工学院

相关 MCP