mcp-gif

MCP server for GIF animation analysis. Provides metadata extraction, individual frame export, and per-frame timing information.

Setup

Claude Code

claude mcp add -s user gif npx mcp-gif

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gif": {
      "command": "npx",
      "args": ["mcp-gif"]
    }
  }
}

Tools

gif_info

Get GIF metadata: dimensions, frame count, delays, loop count, and average FPS.

Input: path — path to a GIF file

Output:

{
  "width": 320,
  "height": 240,
  "frames": 12,
  "delays": [100, 100, 100],
  "loop": 0,
  "avgFps": 10
}

gif_frame

Extract a single frame as a PNG image.

Input: path — path to a GIF file, frame — 0-based frame index

Output: PNG image (base64)

gif_frames_list

List all frames with their index, delay (ms), and FPS.

Input: path — path to a GIF file

Output:

[
  { "index": 0, "delay": 100, "fps": 10 },
  { "index": 1, "delay": 200, "fps": 5 }
]

License

BSD-2-Clause