home / mcp / gif creator mcp server

GIF Creator MCP Server

Converts video files to optimized GIFs with configurable FPS, size, and duration for MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

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

GIF Creator MCP is an MCP server that converts video files into GIF animations with configurable output settings. It is useful for automating GIF generation as part of model-assisted workflows, enabling clients to request video-to-GIF conversions through the MCP protocol.

How to use

To use the GIF Creator MCP server with an MCP client, integrate it as a server endpoint that accepts a convert_video_to_gif request and returns the resulting GIF. You can also run it locally and configure your MCP client to connect via a local stdio setup as shown below.

How to install

Prerequisites: Node.js and FFmpeg (FFmpeg is automatically installed via @ffmpeg-installer/ffmpeg when used by the tool). Install dependencies and build the MCP server.

# Install dependencies
npm install

# Build the project
npm run build

Additional notes about setup and usage

The GIF Creator MCP server supports starting via a local stdio configuration. Use the following MCP config example to run the server locally by invoking Node on the built entry point.

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

Notes

- The output GIF is saved in the same directory as the input video and uses the original filename with a .gif extension.

- Large videos may take significant time to process. The tool uses an optimized palette for higher quality GIFs.

Available tools

convert_video_to_gif

Converts a video file to a GIF file, saving it in the same directory as the source video. Parameters include video_path, fps, width, height, start_time, and duration.