ananddtyagi/gif-creator-mcp

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

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

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.

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"]
    }
  }
}

Tools

convert_video_to_gif

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

Parameters:

• video_path (required): Path to the video file to convert
• fps (optional): Frames per second for the GIF (1-30, default: 10)
• width (optional): Width of the output GIF (maintains aspect ratio if height not specified)
• height (optional): Height of the output GIF (maintains aspect ratio if width not specified)
• start_time (optional): Start time in seconds (default: 0)
• duration (optional): Duration in seconds (default: entire 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
}

Requirements

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

Notes

• 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