Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 0 additions & 11 deletions .mcp.json

This file was deleted.

42 changes: 37 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,11 @@ MCP server that forges pixel art sprites & game assets using Google Gemini — g

## Features

- **AI-powered generation** — sprites, animations, backgrounds, thumbnails via Google Gemini
- **AI-powered generation** — sprites, animations, backgrounds, thumbnails, tilesets, item kits via Google Gemini
- **Smart post-processing** — background removal, auto-crop, pixelation downscale, square padding
- **Sprite sheet splitting** — auto-detect and split sheets into individual frames
- **Seamless tiling** — generate tileable textures for terrain and backgrounds
- **Batch generation** — create multiple related sprites with visual consistency
- **Style presets** — neon, retro, gameboy, snes, clean
- **Pure PNG pipeline** — zero-dependency PNG encoder/decoder, no native modules
- **Reference matching** — pass existing sprites to match visual style
Expand Down Expand Up @@ -70,6 +72,16 @@ Add to your `.mcp.json` or equivalent config:
- Node.js >= 20
- [Google Gemini API key](https://aistudio.google.com/apikey)

## Quick Examples

```
"Generate a green slime enemy sprite, 48px, retro style"
"Create a bouncing ball animation with 4 frames"
"Make a grass tileset texture, 32px"
"Generate fruit item kit: apple, banana, cherry"
"Create space background with stars, 16:9 aspect ratio"
```

## Tools

### `forge_sprite`
Expand Down Expand Up @@ -127,6 +139,28 @@ Post-process an existing PNG — background removal, auto-crop, sprite sheet spl
**Required:** `inputPath`
**Optional:** `outputPath`, `split`, `names`, `threshold`, `square`, `padding`, `skipCrop`, `skipTransparent`

### `forge_tileset`

Generate a seamless tileable pixel art texture. Perfect for terrain, floors, walls, and backgrounds.

```
"Generate grass terrain tileset, 32px"
```

**Required:** `description`, `outputPath`
**Optional:** `size` (default: 32), `style`, `model`

### `forge_item_kit`

Generate multiple related sprites in a single batch for visual consistency. Ideal for item sets, collectibles, or inventory icons.

```
"Generate fruit items: apple, banana, cherry, grapes"
```

**Required:** `items`, `outputPrefix`
**Optional:** `names`, `size` (default: 48), `style`, `background`, `square`, `model`, `references`

### `optimize_sprite`

Downscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).
Expand All @@ -138,16 +172,14 @@ Downscale oversized AI images to true pixel art resolution using area-averaging
**Required:** `inputPath`, `size`
**Optional:** `outputPath`, `removeBackground`, `square`

> Full parameter docs: see [docs/tools.md](docs/tools.md)

## Models

| Alias | Model ID | Notes |
|-------|----------|-------|
| `nano-banana`, `banana` | nano-banana-pro-preview | **Default** — best for pixel art |
| `flash`, `gemini-flash` | gemini-3.1-flash-image-preview | Fast, reliable |
| `flash`, `gemini-flash`, `banana-2`, `nano-banana-2` | gemini-3.1-flash-image-preview | Fast, reliable |
| `pro`, `gemini-pro` | gemini-3-pro-image-preview | Best quality |
| `25`, `gemini-25` | gemini-2.5-flash-image | Stable fallback |
| `25`, `gemini-25`, `gemini-flash-25` | gemini-2.5-flash-image | Stable fallback |

## Prompts

Expand Down
Loading