🚀 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 许可证。