freema avatar

PixelForge

freema/pixelforge-mcp

Forge pixel art sprites, animations, tilesets and game assets with Google Gemini.

GitHub stars
6
tools
8
auth
Secret needed
transport
STDIO
env var
1
last updated
Nov 6, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

forge_spriteGenerate a single pixel art sprite with automatic post-processing (crop, bg removal, downscale, square padding).

Generate a single pixel art sprite with automatic post-processing (crop, bg removal, downscale, square padding).

No parameter schema in public metadata yet.

forge_animationGenerate animation frames as individual, ready-to-use frame PNGs.

Generate animation frames as individual, ready-to-use frame PNGs.

No parameter schema in public metadata yet.

forge_backgroundGenerate a full game background — no cropping, outputs the image as-is.

Generate a full game background — no cropping, outputs the image as-is.

No parameter schema in public metadata yet.

forge_thumbnailGenerate a game thumbnail/screenshot. Pass references for visual consistency with your sprites.

Generate a game thumbnail/screenshot. Pass references for visual consistency with your sprites.

No parameter schema in public metadata yet.

forge_tilesetGenerate a seamless, tileable square texture for terrain, floors and walls. No background removal — the texture fills the whole canvas.

Generate a seamless, tileable square texture for terrain, floors and walls. No background removal — the texture fills the whole canvas.

No parameter schema in public metadata yet.

forge_item_kitGenerate up to 16 related sprites in one batch. Items are drawn together on a grid for visual consistency, then split into individual PNGs.

Generate up to 16 related sprites in one batch. Items are drawn together on a grid for visual consistency, then split into individual PNGs.

No parameter schema in public metadata yet.

process_spritePost-process an existing PNG — background removal, auto-crop, sprite sheet splitting.

Post-process an existing PNG — background removal, auto-crop, sprite sheet splitting.

No parameter schema in public metadata yet.

optimize_spriteDownscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).

Downscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).

No parameter schema in public metadata yet.

Sponsors

Configuration

GEMINI_API_KEY*secret

Google Gemini API key (https://aistudio.google.com/apikey)

Readme

pixelforge-mcp

MCP server that forges pixel art sprites & game assets using Google Gemini — generate, crop, split & process, all from your AI assistant.

Features

  • AI-powered generation — sprites, animations, backgrounds, thumbnails, tilesets and item kits via Google Gemini
  • Smart post-processing — background removal, auto-crop, pixelation downscale, square padding
  • Chroma key transparency — background: "chromakey" generates on pure green and keys it out in HSV space for clean edges
  • Sprite sheet splitting — auto-detect and split sheets into individual frames
  • Style presets — neon, retro, gameboy, snes, clean
  • Pure PNG pipeline — zero-dependency PNG encoder/decoder, no native modules
  • Reference matching — pass existing sprites to match visual style

Installation

Claude Code (CLI)

claude mcp add pixelforge npx pixelforge-mcp@latest \
  --env GEMINI_API_KEY=your-api-key

Claude Code (Plugin)

/plugin marketplace add freema/pixelforge-mcp
/plugin install pixelforge-mcp

Restart Claude Code to load the MCP server (check with /mcp).

Claude Desktop


View the full README on GitHub

Details

Repository
github.com/freema/pixelforge-mcp
Categories
AI & LLM Tools, Design & Creative
Package
pixelforge-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from freema

Related AI & LLM Tools MCP servers

View all
1bitbond avatarToken Toolbitbond/token-tool-mcpDeploy compliant ERC-20 tokens from any AI agent. 17 tools, 10 networks, CertiK-audited.6stars
2scrollmark avatarSocialGPTscrollmark/socialgpt-mcpSocial media analytics, video analysis, and competitor intel for any MCP-compatible AI agent.6stars
3sharozdawa avatarAi Visibilitysharozdawa/ai-visibilityTrack brand visibility across ChatGPT, Perplexity, Claude, and Gemini.6stars
4sowiedu avatarEdictsowiedu/edictAI-agent programming language. JSON AST in, WASM out. Typed, effect-tracked, Z3-verified.6stars
5spectra-g avatarEngramspectra-g/engramMCP adapter for Engram - organizational memory for AI agents6stars
6writbase avatarWritbasewritbase/writbaseMCP-native task management for AI agent fleets with scoped permissions and provenance.6stars