Video to GIF Converter MCP

基于 MCP (Model Context Protocol) 的视频转 GIF 服务器，使用 FFmpeg 两遍调色板优化法生成高质量 GIF。

功能特性

• 两遍调色板优化: palettegen/paletteuse 两遍法，生成高质量 GIF
• 帧率控制: 自定义 GIF 帧率
• 尺寸调整: 支持宽度/高度设置，保持或不保持宽高比
• 时间裁剪: 指定起始时间
• 区域裁剪: 指定裁剪区域 (x, y, w, h)
• 调色算法: 支持 floyd_steinberg、bayer、sierra2_4a 等
• 颜色数控制: 2-256 色调色板
• 循环设置: 无限循环或指定次数

安装

通过 uvx 安装（推荐）:

uvx mcpcn-video-to-gif

或通过 pip 安装:

pip install mcpcn-video-to-gif

使用方法

启动 MCP 服务器:

mcpcn-video-to-gif

系统要求

• Python >= 3.12
• FFmpeg（需要系统安装）

环境变量

• FFMPEG_BINARY: 指定 FFmpeg 可执行文件路径
• FFPROBE_BINARY: 指定 FFprobe 可执行文件路径

工具说明

convert_video_to_gif

将视频片段高质量导出为 GIF。

参数:

支持的调色算法 (dither):

调色板统计模式 (palette_stats_mode):

使用示例

# 基本转换
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif"
)

# 高质量设置
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif",
    fps=15,
    width=480,
    max_colors=256,
    dither="floyd_steinberg"
)

# 裁剪区域
convert_video_to_gif(
    video_path="/path/to/video.mp4",
    output_gif_path="/path/to/output.gif",
    crop={"x": 100, "y": 50, "w": 320, "h": 240},
    start_time="00:00:05"
)

License

MIT License