# PixelForge

PixelForge — an MCP server for Claude Code that creates pixel-art assets with Google Gemini. Ask it to generate sprites, animation frames, backgrounds, or process PNG files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: freema
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/freema/pixelforge-mcp
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pixelforge

## What it does

PixelForge generates pixel-art sprites, animation frames, backgrounds, thumbnails, and tilesets. It can also remove image backgrounds, crop PNGs, reduce oversized art, and split sprite sheets into separate frames. Use `process_sprite` for PNG processing and `optimize_sprite` to downscale an image.

The server needs Node.js 20 or later and a Google Gemini API key set as `GEMINI_API_KEY`. It runs through `npx` and writes generated images to the requested paths. Reference sprites can guide visual style matching.

\`forge_item_kit` creates a batch of up to 16 related sprites, then saves them as separate PNGs. Avoid `chromakey` for bright green subjects: the keying step can remove green pixels belonging to the sprite.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GEMINI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pixelforge --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pixelforge": {
            "command": "npx",
            "args": [
                "-y",
                "pixelforge-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pixelforge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pixelforge-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> pixelforge npx -y pixelforge-mcp
```
Replace <…> with your own values

## When to use it
- generate a pixel-art sprite with its background removed
- split a sprite sheet into individual PNG frames
- create animation frames with a consistent visual style
- make a tileset for floors or walls
- downscale a large image to pixel-art resolution

## Example prompts
- Create a pixel-art knight sprite and save it as `assets/knight.png`.
- Make a slime jumping animation with 4 frames.
- Split `assets/spritesheet.png` into separate frames.

## Similar
- [layer-pixel-art](https://affpapa.org/en/nevibecode/skills/layer-pixel-art.md) — skill · 5100 installs
- [game-assets](https://affpapa.org/en/nevibecode/skills/meowa-ai-game-assets.md) — skill · 1400 installs
- [retrodiffusion](https://affpapa.org/en/nevibecode/skills/retrodiffusion.md) — skill · 654 installs
- [fal-gamedev](https://affpapa.org/en/nevibecode/skills/fal-gamedev.md) — skill · 432 installs
- [Retro Diffusion Pixel Art](https://affpapa.org/en/nevibecode/mcp/retro-diffusion-pixel-art.md) — MCP server · ★ 8 repo stars
- [transparent-cutout-cleanup](https://affpapa.org/en/nevibecode/skills/transparent-cutout-cleanup.md) — skill · ★ 51 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
