Zpup
MCP server that lets AI models build 3D scenes from JSON and check their own renders
Zpup is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, API, Linux
- Runs
- Locally
- Version
- 0.3.1
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add zpup -- npx -y @zpup/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"zpup": {
"command": "npx",
"args": [
"-y",
"@zpup/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"zpup": {
"command": "npx",
"args": [
"-y",
"@zpup/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"zpup": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zpup/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"zpup": {
"command": "npx",
"args": [
"-y",
"@zpup/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"zpup": {
"command": "npx",
"args": [
"-y",
"@zpup/mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
About Zpup
The README says an AI model writes a small 3D scene as JSON, then receives errors that point to the faulty path along with suggested fixes. The server turns the scene into a flat SVG seen from any chosen angle and returns a PNG preview so the model can inspect its output and correct it.
It exposes four tools: one returns the scene-writing reference, one validates a scene without drawing it, one renders stills from up to six angles, and one produces an SVG that turns continuously with no JavaScript. Invalid scenes draw nothing, and the reply lists every problem at once.
The package runs locally over stdio through npx, needs Node 20 or later, and makes no network requests. It only writes files when a call passes an explicit save path. It suits developers wiring up MCP clients who want a model to iterate on simple 3D illustrations.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- get_reference
- Returns how to write a scene: the format, every shape and its options, and axis and angle conventions.
- check_scene
- Checks a scene without drawing it and returns errors with paths and fixes, plus warnings.
- render_scene
- Draws the scene and returns a PNG, the SVG text, and any warnings, optionally from several views.
- render_spin
- Makes an SVG that turns the scene forever with no JavaScript, returning PNG stills of the turn.
What it does
- Scene validation
- Checks a scene without drawing it and returns each error with its path and a fix.
- Multi-angle rendering
- Draws the same scene from up to six view angles in a single call.
- PNG previews
- Returns a PNG of each picture so a model can look at its own output.
- Spinning SVG output
- Produces an SVG that turns forever with no JavaScript, plus stills of the turn.
- Local stdio operation
- Runs offline over standard input and output and writes files only when asked.
Good for
- Letting an AI assistant draft simple 3D scenes and correct its own mistakes
- Generating flat SVG illustrations of 3D shapes from several angles
- Producing looping rotating SVG graphics for web pages
- Validating JSON scene files before rendering them
Pricing
Open source
MIT licensed, free to run locally.
Zpup FAQ
Does the server make network requests?
No. The README says it reads no files of yours and makes no network requests, and only writes a file when a call passes save_to.
What does Zpup need to run?
Node 20 or later. It is started with npx using the package @zpup/mcp over stdio.
What are the stated limits?
The README lists stills and one kind of turn, no perspective, no text shapes, and shapes that cut deep into each other are not drawn correctly.
Is Zpup free?
Yes. Zpup is open source, so you can use and self-host it for free.
How do I add Zpup to Claude Code?
Run this command in your terminal: claude mcp add zpup -- npx -y @zpup/mcp
What are the best alternatives to Zpup?
The closest alternatives to Zpup are mcp-for-blender, AI Photo Editor MCP, SceneView, Figma To Code MCP and MCP Server Template.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

