2D Assets MCP — Claude Code MCP server: install
This MCP server creates PNG placeholders for game prototypes, including sprites, health bars, and UI elements. Use it to test scale and animation timing before final art.
claude mcp add 2d-assets-mcp -- npx -y 2d-assets-mcpWhat 2D Assets MCP does
2D Assets MCP generates PNG files inside the project folder through an AI client. It can produce sprites, animation spritesheets, buttons, health bars, and other interface elements. Visual options include gradients, pattern overlays, transparency, rotated text, and labels that scale to fit the asset.
Generated PNGs carry JSON metadata in EXIF with details such as dimensions, colors, shapes, gradients, patterns, text, and strokes. File names include dimensions, which helps models without vision identify an asset. The server writes to the path supplied by the AI client, so access should be limited to the game project and output paths should be reviewed before confirmation. Claude Code setup uses npx with the 2d-assets-mcp package.
What it helps with
- create a PNG placeholder for a game object
- build a spritesheet for a short animation
- draw a health bar with a chosen fill level
- prepare a button or other game UI element
- test scale and animation timing before final art
Example prompts for the agent
- Create an attack button as
button_attack_128x48.pngwith a red gradient and the label ATTACK. - Generate a hero idle-animation spritesheet and save it in the project folder.
- Make
health_bar_200x24.pngwith the bar filled to 75 percent.
How to install 2D Assets MCP
Platform CLI
claude mcp add 2d-assets-mcp -- npx -y 2d-assets-mcpPlatform CLI
codex mcp add 2d-assets-mcp -- npx -y 2d-assets-mcpConfig file
{
"mcpServers": {
"2d-assets-mcp": {
"command": "npx",
"args": [
"-y",
"2d-assets-mcp"
]
}
}
}Config file
{
"servers": {
"2d-assets-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"2d-assets-mcp"
]
}
}
}Platform CLI
gemini mcp add 2d-assets-mcp npx -y 2d-assets-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about 2D Assets MCP
How do I install 2D Assets MCP in Claude Code?
Run claude mcp add 2d-assets-mcp -- npx -y 2d-assets-mcp. This adds the MCP server to Claude Code.
What does 2D Assets MCP do?
It creates PNG placeholders for game prototypes, such as sprites, animation spritesheets, buttons, and health bars. The images also include JSON metadata that can be read without loading their pixels.
Where does 2D Assets MCP write generated files?
It writes files to the path provided by the AI client. Limit access to the game project directory and review paths before confirming an operation.
