2D Assets MCP

2d-assets-mcp

_Design your game's feel before you design its art._

Just like wireframing helps designers visualize user flows before start sketching, _2d-assets-mcp_ helps game developers visualize timing, frames-per-second (FPS), collision boundaries, and UI layouts before spending hours on final artwork.

This [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server lets any AI assistant (Antigravity, Claude Code, Codex, Devin, or any of them as long as it's MCP-compatible) generate advanced 2D mock/placeholder assets in PNG format right into your project folder. Save time and prototype faster, nail your game's feel with 2d-assets-mcp, and then replace the mockups with original artwork when you are ready.

This MCP is engine-agnostic and it works flawlessly with any game engine that supports PNG import, like:

• Godot
• Unity
• Unreal Engine
• GameMaker
• Construct
• RPG Maker
• And many more!

Save time and create placeholder health bars, spritesheets, and whatever UI elements you can think of with full support for gradients, patterns, transparency, text rotation, and auto-scaling, all via chat and without ever opening an image editor. The idea behind it is to help you test and iterate how your game feels first by prototiping scale, jump arcs, and animation timing without waiting on final art assets, and also with zero friction: Need that placeholder button to be 20% larger? Just ask your AI client to regenerate it.

[!TIP]

2d-assets-mcp has AI-Friendly Metadata → meaning each generated PNG embeds rich JSON metadata (dimensions, color, shape, gradient properties, pattern details, text properties, stroke properties, description) directly in its EXIF data, so AI models without vision can still understand what an asset contains.

Generated Assets Examples

Here are some example assets generated by this MCP server:

Character Sprites & Animations

Hero Idle Animation (8 frames, 512x64)

*8-frame idle animation spritesheet with effect*

UI Elements

Attack Button (128×48)

*Button with red gradient, rounded corners, and "ATTACK" label*

Health Bar (200×24)

*Health bar at 75% fill with green color and dark gray track*

Game Items

Gold Coin (32×32)

*Circular coin with radial gradient, dot pattern overlay, and "COIN" label*

Grass and water

Trees

Animation Spritesheets

Fire animation (4 frames, 192x48)

*4-frame spritesheet*

Security Considerations

Asset Content

• Generated assets are pure placeholder graphics and they do not contain malicious code.
• Embedded metadata is plain JSON and is not executable.

Because this MCP server writes files directly to your machine to save you time, please review these security best practices:

File System Access

• The server can write files to any path specified by the AI assistant.
• Recommendation: Configure your AI client to restrict access strictly to your game's project directories.
• Warning: Be cautious when asking the AI to generate assets outside your project directory.

Path Traversal

• This server validates paths, but you should always be aware of potential path traversal attempts when dealing with MCP servers, and review generated file paths before confirming operations.

Overall Best Practices

• Use absolute paths in configurations to prevent ambiguity.
• Restrict AI access to your game project directory only.
• Review generated assets before committing to version control.
• Keep your Node.js dependencies updated.

Core Features

• Instant asset generation: one tool call, one PNG, full visual configuration.
• Spritesheet & Batch mode: generate multiple frames or composite them into a single animation-strip spritesheet in one request.
• Rich visuals: support for solid fills, linear/radial gradients, stripe/dot/grid pattern overlays, rounded corners, circles, opacity, and stroke control.
• Dynamic UI Elements: create partially filled progress/health bars using fillPercent and trackColor for partially-filled assets.
• Auto-scaling labels: text automatically scales to fit the asset, or you can override it with explicit fontSize if needed.
• Non-vision AI friendly: embedded JSON metadata readable back via read_image_metadata, without loading image pixels, ideal for non-vision AI workflows.
• Smart naming: output files are automatically named with their dimensions (e.g. player_idle_128x128.png) to help models with no vision know the dimensions when using the asset.

Tools Reference

This MCP server equips your AI with 3 tools to generate and read 2D asset metadata.

1. generate_mock_asset

Generates a single PNG asset and writes it to the disk. It supports gradients, patterns, transparency, text rotation, and embedded metadata.

Parameters (press to expand)

*Required parameters*

Optional parameters: _shape & size_

Optional parameters: _fill & gradient_

Optional parameters: _progress/health bar_

Optional parameters: _pattern overlay_

Optional parameters: _text_

Optional parameters: _metadata_

[!NOTE]

Output filename format

The server automatically appends the dimensions to the filename before writing:

player_idle.png  →  player_idle_128x128.png

2. generate_mock_asset_batch

Generates multiple assets in one request. Supports individual PNGs or a single composed spritesheet.

Parameters (press to expand)

*Required parameters*

Optional parameters

| spritesheetMode | individual \ `spr