# mcp-gif

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

## Setup

### Claude Code

```bash
claude mcp add -s user gif npx mcp-gif
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

```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**:
```json
{
  "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**:
```json
[
  { "index": 0, "delay": 100, "fps": 10 },
  { "index": 1, "delay": 200, "fps": 5 }
]
```

## License

BSD-2-Clause