DF

dubnium0/ffmpeg-mcp

数据科学与机器学习

本页由 AI 翻译,技术细节请以原文为准。 查看原文

21 stars 3 forks 质量 57 趋势 10

高级ffmpeg mcp服务器

概览

模型上下文协议(MCP)服务器,提供视频/音频处理、分析和流媒体 - — 全面的元数据(编解码器、码率、分辨率、帧率等) - — 宽度、高度、宽高比 - — 文件时长(秒数)及格式化 - — 所有视频、音频、字幕流 - — 总帧数 - — 带时间戳的场景剪接检测 - — 关键帧时间戳列表 - — 完整的编解码器/质量控制(x264、x265、VP9、AV1等) - 音频格式转换(MP3、AAC、FLAC、WAV、OGG等) - — 高质量GIF带调色板优化 - — 批量转换整个目录 - — 从视频中提取音频轨道 - — 按时间切割片段 - — 串接多个视频 - — 可按任意分辨率缩放 - — 通过音频同步加速/减速 - — 将帧导出为图像 - — 视频→图像序列 - — 90°、180°、270° 或任意角度 - — 裁剪区域 - — 将帧提取为图像 - — 将海报图像嵌入MP4 - — 音量控制(因子、dB、百分比)- — EBU R128响度归一化 - —...

概述(AI 翻译)

模型上下文协议(MCP)服务器,提供40+高级FFmpeg工具用于视频/音频处理、分析和流媒体

特色

媒体分析与探查(7个工具)

  • get_media_info — 全面的元数据(编解码器、码率、分辨率、帧率等)
  • get_video_resolution — 宽度、高度、宽高比
  • get_duration — 文件时长(秒)及格式化
  • list_streams — 所有视频、音频、字幕流
  • get_frame_count — 总帧数
  • detect_scene_changes — 带时间戳的场景剪辑检测
  • get_keyframes — 关键帧时间戳列表

格式转换(5个工具)

  • convert_video — 完整的编解码器/质量控制(x264、x265、VP9、AV1等)
  • convert_audio — 音频格式转换(MP3、AAC、FLAC、WAV、OGG 等)
  • convert_to_gif — 带调色板优化的高质量GIF。
  • batch_convert — 批量转换整个目录
  • extract_audio — 从视频中提取音频轨道

视频剪辑(10个工具)

  • trim_video — 按时间剪辑片段
  • merge_videos — 将多个视频串联起来
  • resize_video — 可按任意分辨率进行缩放
  • change_speed — 通过音频同步加速/减速

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

FFmpeg MCP Server

Model Context Protocol (MCP) server that provides 40+ advanced FFmpeg tools for video/audio processing, analysis, and streaming

Features

Media Analysis & Probing (7 tools)

  • get_media_info — Comprehensive metadata (codecs, bitrates, resolution, fps, etc.)
  • get_video_resolution — Width, height, aspect ratio
  • get_duration — File duration in seconds & formatted
  • list_streams — All video, audio, subtitle streams
  • get_frame_count — Total frame count
  • detect_scene_changes — Scene cut detection with timestamps
  • get_keyframes — Keyframe timestamp listing

Format Conversion (5 tools)

  • convert_video — Full codec/quality control (x264, x265, VP9, AV1, etc.)
  • convert_audio — Audio format conversion (MP3, AAC, FLAC, WAV, OGG, etc.)
  • convert_to_gif — High-quality GIF with palette optimization
  • batch_convert — Bulk convert entire directories
  • extract_audio — Extract audio track from video

Video Editing (10 tools)

  • trim_video — Cut segments by time
  • merge_videos — Concatenate multiple videos
  • resize_video — Scale to any resolution
  • change_speed — Speed up / slow down with audio sync
  • extract_frames — Export frames as images
  • create_video_from_images — Image sequence → video
  • rotate_video — 90°, 180°, 270° or arbitrary angle
  • crop_video — Crop a region
  • generate_thumbnail — Extract frame as image
  • add_thumbnail — Embed poster image in MP4

Audio Processing (7 tools)

  • adjust_volume — Volume control (factor, dB, percentage)
  • normalize_audio — EBU R128 loudness normalization
  • mix_audio — Overlay/replace audio tracks
  • remove_audio — Strip all audio
  • add_fade_audio — Fade in/out effects
  • generate_waveform — Audio waveform visualization
  • generate_spectrogram — Spectrogram image generation

Visual Effects & Filters (7 tools)

  • add_text_overlay — Text/watermark with position, timing, styling
  • add_image_overlay — Logo/watermark image overlay
  • apply_video_filter — Any FFmpeg filter (blur, sharpen, eq, hue, etc.)
  • add_fade — Video fade in/out
  • picture_in_picture — PiP effect with two videos
  • side_by_side — Horizontal/vertical split view
  • create_slideshow — Image slideshow with transitions (fade, wipe, slide)

Subtitles (3 tools)

  • extract_subtitles — Extract subtitle tracks (SRT, ASS, VTT)
  • burn_subtitles — Hardcode subtitles into video
  • add_subtitle_track — Add soft subtitles with language tags

Streaming (4 tools)

  • create_hls_stream — Generate HLS segments + playlist
  • create_dash_stream — Generate DASH manifest + segments
  • create_adaptive_hls — Multi-bitrate adaptive streaming (1080p/720p/480p/360p)
  • stream_to_rtmp — Stream to YouTube Live, Twitch, etc.

Advanced Processing (14 tools)

  • two_pass_encode — Optimal bitrate distribution
  • stabilize_video — Shake reduction (vidstab)
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

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