PixelForge
Generates pixel art sprites, animations and tilesets with Gemini from your assistant
- 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-mcpAdd 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.



