Gif Creator MCP

🚀 GIF Creator MCP

An MCP (Model Context Protocol) server that converts video files to GIF animations.

🚀 Quick Start

This is an MCP server designed to convert video files into GIF animations. You can use it to generate high - quality GIFs from various video sources.

✨ Features

• Convert any video file to GIF format.
• Customize output settings (FPS, dimensions, duration).
• Extract specific portions of videos.
• High - quality GIF generation with optimized palette.

📦 Installation

npm install
npm run build

💻 Usage Examples

Basic Usage

Right now, Claude Desktop does not support video input. I'd recommend using a different client like Goose and adding it as an extension.

In Goose, you can use the Gif Creator tool by going to Advanced Settings > Extension > + Add Custom Extension > and in the command pasting:

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

I'd also increase the time out to 1000.

Advanced Usage

For other MCP clients, you can use the following command to start the server:

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

📚 Documentation

Tools - convert_video_to_gif

Converts a video file to a GIF file, saving it in the same directory as the source video.

Examples

Basic conversion

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

Custom settings

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

Extract a specific portion

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

🔧 Technical Details

Requirements

• Node.js
• FFmpeg (automatically installed via @ffmpeg-installer/ffmpeg)

Notes

⚠️ Important Note

• The output GIF is saved in the same directory as the input video.
• The filename is the same as the video file but with a .gif extension.
• Large videos may take some time to process.
• The tool uses optimized palette generation for better quality GIFs.

📄 License

MIT