Skip to main content
MCP server CX Codex

PixelForge — Claude Code MCP server: sprites and setup

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.

MIT ★ 6 updated 2026-11-06

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp
Open on GitHub

What PixelForge 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.

What it helps with

  • 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 for the agent

  • 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.

How to install PixelForge

Platform CLI

claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about PixelForge

How do I install PixelForge in Claude Code?

Run claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp. Replace the placeholder with a Google Gemini API key.

What does PixelForge do?

It generates pixel-art game assets with Google Gemini and processes PNGs, including background removal, cropping, downscaling, and sprite-sheet splitting.

What does PixelForge need to run?

It requires Node.js 20 or later and a Google Gemini API key supplied through GEMINI_API_KEY.

Similar MCP servers

All MCP servers for Game dev and 3D: Unity, Unreal, Godot, Blender →

Project sponsors

Companies that keep this analytics open