Skip to content
MCP server

PixelForge

Generates pixel art sprites, animations and tilesets with Gemini from your assistant

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About PixelForge

PixelForge is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Image models tend to draw pixel art too large, blurry or on messy backgrounds. This server generates through Google Gemini and then cleans the result up: it removes the background, auto-crops, downsamples with area averaging rather than blurry bilinear scaling, and can pad to a square. A chromakey option generates on pure green and keys it out in HSV space for clean edges, which the README advises against for sprites that are themselves bright green.

Animations are generated frame by frame with the first frame passed as a reference so proportions and colours stay consistent, or as a single sheet that is split automatically. Item kits draw up to 16 related sprites on one grid and split them into separate PNGs. Style presets cover neon, retro, gameboy, snes and clean.

You supply your own Gemini API key, and the PNG pipeline has no native modules. The code is MIT licensed.

Install

Run in a terminal

claude mcp add pixelforge-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y pixelforge-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pixelforge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pixelforge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pixelforge-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pixelforge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pixelforge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GEMINI_API_KEYGoogle Gemini API key (https://aistudio.google.com/apikey)Required

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

forge_sprite
Generates one pixel art sprite with automatic post-processing.
forge_animation
Generates animation frames as individual PNGs.
forge_background
Generates a full game background without cropping.
forge_thumbnail
Generates a game thumbnail or screenshot.
forge_tileset
Generates a seamless tileable texture.
forge_item_kit
Generates up to 16 related sprites in one batch.
process_sprite
Removes backgrounds, crops and splits sprite sheets in an existing PNG.
optimize_sprite
Downscales oversized AI images to true pixel art resolution.

What it does

Sprite generation
Creates a single sprite with automatic crop, background removal and downscale.
Animation frames
Produces frame PNGs, using a reference chain for consistency.
Item kits
Draws up to 16 related sprites in one batch and splits them.
Seamless tilesets
Generates tileable square textures for terrain, floors and walls.
Chroma key transparency
Keys out a green background in HSV space.
Style presets
Neon, retro, gameboy, snes and clean looks, plus reference images to match style.

Good for

  • Make placeholder or final sprites for a game jam
  • Generate walk or bounce animation frames
  • Create seamless terrain tiles
  • Split an existing sprite sheet into frames

Pricing

Open source

MIT licence; requires your own Gemini API key

PixelForge FAQ

What do I need to run it?

Node.js 20 or newer and a Google Gemini API key.

Which Gemini models can it use?

Aliases map to nano-banana-pro-preview (default), gemini-3.1-flash-image-preview, gemini-3-pro-image-preview and gemini-2.5-flash-image.

What licence is it under?

MIT.

Can it process images it did not generate?

Yes, process_sprite and optimize_sprite work on existing PNGs.

Is PixelForge free?

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

How do I add PixelForge to Claude Code?

Run this command in your terminal: claude mcp add pixelforge-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y pixelforge-mcp

What are the best alternatives to PixelForge?

The closest alternatives to PixelForge are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers