pixelforge-mcp

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

• AI-powered generation — sprites, animations, backgrounds, thumbnails via Google Gemini
• Smart post-processing — background removal, auto-crop, pixelation downscale, square padding
• 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

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

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

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

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": ["-y", "pixelforge-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Add to your .mcp.json or equivalent config:

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": ["-y", "pixelforge-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

• Node.js >= 20
• Google Gemini API key

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

"Generate a green slime enemy sprite, 48px, retro style"

Required: description, outputPath Optional: size (default: 48), style, background, aspect, square, model, references

Generate a