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
claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcpWhat 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.pnginto separate frames.
How to install PixelForge
Platform CLI
claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcpReplace <…> with your own values
Platform CLI
codex mcp add pixelforge --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"pixelforge": {
"command": "npx",
"args": [
"-y",
"pixelforge-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"pixelforge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pixelforge-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> pixelforge npx -y pixelforge-mcpReplace <…> 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.