gif-creator-mcp

🚀 GIF Creator MCP

GIF Creator MCP 是一个 MCP（模型上下文协议）服务器，可将视频文件转换为 GIF 动画。它能帮助你轻松地把各种视频转换为高质量的 GIF 格式，满足多样化的使用需求。

✨ 主要特性

• 可将任意视频文件转换为 GIF 格式。
• 能够自定义输出设置，如帧率（FPS）、尺寸和时长。
• 可以提取视频的特定部分。
• 采用优化调色板生成高质量的 GIF。

📦 安装指南

npm install
npm run build

💻 使用示例

基础用法

目前，Claude Desktop 不支持视频输入。建议使用其他客户端，如 Goose 并将其作为扩展添加。 在 Goose 中，你可以通过以下步骤使用 Gif Creator 工具：进入高级设置 > 扩展 > + 添加自定义扩展，然后在命令中粘贴：

node /path/to/gif-creator-mcp/dist/index.js

同时，建议将超时时间增加到 1000。

对于其他 MCP 客户端，你可以使用以下命令启动服务器：

{
  "mcpServers": {
    "gif-creator": {
      "command": "node",
      "args": ["/path/to/gif-creator-mcp/dist/index.js"]
    }
  }
}

高级用法

工具 convert_video_to_gif

该工具可将视频文件转换为 GIF 文件，并将其保存到源视频所在的同一目录。

参数说明：

• video_path（必填）：要转换的视频文件路径。
• fps（可选）：GIF 的帧率（范围 1 - 30，默认值为 10）。
• width（可选）：输出 GIF 的宽度（若未指定高度，则保持宽高比）。
• height（可选）：输出 GIF 的高度（若未指定宽度，则保持宽高比）。
• start_time（可选）：开始时间（以秒为单位，默认值为 0）。
• duration（可选）：时长（以秒为单位，默认值为整个视频）。

具体示例

基本转换

{
  "video_path": "/path/to/video.mp4"
}

自定义设置

{
  "video_path": "/path/to/video.mp4",
  "fps": 15,
  "width": 480,
  "start_time": 5,
  "duration": 10
}

提取特定部分

{
  "video_path": "/path/to/long-video.mov",
  "start_time": 30,
  "duration": 5,
  "fps": 20
}

🔧 技术细节

依赖要求

• Node.js
• FFmpeg（通过 @ffmpeg-installer/ffmpeg 自动安装）

注意事项

⚠️ 重要提示

• 输出的 GIF 文件将保存在输入视频所在的同一目录。
• 文件名与视频文件相同，但扩展名为 .gif。
• 处理大视频可能需要一些时间。
• 该工具使用优化调色板生成以提高 GIF 质量。

📄 许可证

本项目采用 MIT 许可证。