# GIF Creator MCP

An MCP (Model Context Protocol) server that converts video files to GIF animations.
![gif-creator-demo](https://github.com/user-attachments/assets/0543d53f-8bc7-4a16-8a4b-e41ef13568c6)


## 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

```bash
npm install
npm run build
```

## Usage

Right now, Claude Desktop does not support video input. I'd recommend using a different client like [Goose](https://block.github.io/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:

```json
{
  "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
```json
{
  "video_path": "/path/to/video.mp4"
}
```

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

### Extract a specific portion
```json
{
  "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