# Image Puma

> Image Puma is an open-source MCP server for design and media. Plan and run local batch image preparation with explicit confirmation before writing files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/panth-net/image-puma
- **MCP Registry name:** io.github.panth-net/Image-Puma
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-13

## About

Plan and run local batch image preparation with explicit confirmation before writing files.

## Install

### Claude Code (Terminal)

```sh
claude mcp add image-puma -- npx -y image-puma
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "image-puma": {
      "command": "npx",
      "args": [
        "-y",
        "image-puma"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "image-puma": {
      "command": "npx",
      "args": [
        "-y",
        "image-puma"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "image-puma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "image-puma"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "image-puma": {
      "command": "npx",
      "args": [
        "-y",
        "image-puma"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "image-puma": {
      "command": "npx",
      "args": [
        "-y",
        "image-puma"
      ]
    }
  }
}
```

## FAQ

### Is Image Puma free?

Yes. Image Puma is open source, so you can use and self-host it for free.

### How do I add Image Puma to Claude Code?

Run this command in your terminal: claude mcp add image-puma -- npx -y image-puma

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/image-puma
