Heroquarium ArtGen MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Heroquarium ArtGen
Pixel-art asset pipeline for the game Heroquarium: procedural generation
(procgen), external-art normalization (pixelize), and an MCP server that
exposes both to Claude. See ARTGEN_BLUEPRINT.md for the full design.
Canon: generate at TILE=32, export downscaled to 16 for the current
renderer. All output snaps to the 53-colour palette in palette.json (single
source of truth). RGBA, binary alpha, light from top-left.
Layout
palette.json canonical palette (53 colours) — do not diverge
artgen/
palette.py load, redmean nearest-match, quantize, ramps
canvas.py pixel-map DSL, value noise, dither, shadow, outline, mirror
pixelize.py normalize any image/atlas -> palette + tile size
procgen/ procedural generators (M2+)
mcp/ MCP server (M5)
tools/ original game sources, kept for reference
tests/ palette + canvas acceptance tests
references/ style refs + Recraft prompts (for nngen / M7-M8)
out/ generated art (gitignored)Related MCP server: Aseprite MCP Server
Setup
pip install -e '.[dev]' # runtime + pytest
pytest -q # 14 testspixelize
# single sprite -> 16x16 in palette
python -m artgen.pixelize in.png -o out/tree.png
# atlas: 4x4 grid, or 32px source tiles -> separate files
python -m artgen.pixelize sheet.png --grid 4 4 -o out/
python -m artgen.pixelize sheet.png --src-tile 32 -o out/--method box|lanczos for "fat" (AI/painted) art, nearest for already-pixel art.
procgen
python -m artgen.procgen terrain --tile 32 --seed 42 --variety 3 -o out/terrain/
python -m artgen.procgen nature --tile 32 --seed 42 -o out/nature/
python -m artgen.procgen autotile --from grass --to water -o out/edges/
python -m artgen.procgen building --size L --roof red --walls stone -o out/
python -m artgen.procgen village -o out/village/
python -m artgen.procgen all -o out/Buildings: parametric houses (size S/M/L x roof slate/red/thatch x walls stone/
timber/frame) plus a prop kit — fence, gate, well, barrel, crate, signpost,
lantern, market stall, woodpile, haystack. village writes the whole catalog +
a gallery sheet.
Terrain biomes: grass (+flowers), forest_floor, dirt, sand, stone, snow, swamp,
plus animated water frames — all tileable (seamless when repeated). Nature
props: round/pine/palm trees, bush, stump, boulder, small rock, flowers,
mushroom, grass tuft, reeds, skull. Each run writes PNGs + a _*_sheet.png
contact sheet.
Status
M1 — done: scaffold, palette, canvas primitives, pixelize ported.
M2 — done: tileable terrain (7 biomes + water), 12 nature props, preview (contact sheets, 3x3 tiling check), procgen CLI.
M3 — done: corner-based 16-tile autotile transitions between any two biomes, organic edges, dark rim, animated water foam. Seams exact by construction (bilinear corner field + edge-vanishing noise). Emits a bitmask manifest for the game renderer. 28 tests green.
M4 — done: parametric buildings (3x3x3 house combos: size x roof x walls)
10-piece prop kit (fence/gate/well/barrel/crate/signpost/lantern/stall/ woodpile/haystack), gallery preview, village catalog. 35 tests green.
M1-M4 polish pass — done: warm low-contrast terrain with soft details (sprigs/pebbles/rare pale flowers) + new biomes (pine_floor, gravel, cobble, dirt, path) and 6+ variants each to kill repetition; roads/paths as a linear autotile feature (
roads.py, layouts cross/curve/plaza…) with grassy fringe; reference-level detailed houses (varied shingles, ridge cap, moss, 4-pane windows w/ muntins+shutters+glow, timber framing, stone base, framed door, capped chimney) + decor kit (bucket, sack, potted plant, flower box, lantern, axe-stump, …). Demo:python scripts/demo_scene.py. 40 tests green.Anti-repetition pass — done: autotile tiles take a position-hashed
variantthat reseeds interior noise + fill (seams stay exact because noise vanishes at edges), so roads/maps no longer show a repeating pattern;terrain.ground_rect()bakes a large continuous ground field (soft patches flow across the whole area, no per-tile rhythm) for scene/chunk backgrounds; softer terrain details + more nature (flat rock, fallen branch, mushroom cluster).M5+ — MCP server, export/integration, nngen (GPU). §11.
Autotile scheme
Corner 4-bit Wang / dual-grid: each tile's four corners (NW=1, NE=2, SE=4,
SW=8) mark upper vs lower terrain, giving 16 tiles. The boundary along any edge
is a pure function of that edge's two shared corners, so tiles that abut on the
dual grid are exactly seamless (0-mismatch, verified in tests). The renderer
picks a tile per world corner-cell from its 2x2 terrain values; the mapping is
written to <from>_<to>.manifest.json.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
Generate, edit, style-match, turn, and animate game-ready pixel art at exact sizes.
Generate pixel art sprites, animations, 8-direction rotations and palettes for games.
Turn images into pixel art, extract and remap palettes, and upscale sprites without blur.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables LLMs to create and edit pixel art reliably with support for layers, frames, symmetry, and various drawing tools.70MIT No Attribution
- AlicenseAqualityBmaintenanceEnables AI to create pixel art in Aseprite through pixel-level drawing primitives, read canvas screenshots, and iterate until satisfied.317MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to procedurally generate, edit, quantize, and export 2D retro pixel art textures and tilesets for game development, with built-in palettes, dithering, and pixel-level manipulation tools.14MIT
- AlicenseBqualityBmaintenanceEnables AI agents to create and refine pixel art and sprite animations through MCP tools, including seeded generators, indexed palettes, shading, animation presets, inline PNG previews, and multi-format export.28MIT