# Zpup

> Zpup is an open-source MCP server for design and media. MCP server that lets AI models build 3D scenes from JSON and check their own renders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows
- **Repository:** https://github.com/rxolve/zpup/tree/HEAD/mcp
- **MCP Registry name:** io.github.rxolve/zpup
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add zpup -- npx -y @zpup/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zpup": {
      "command": "npx",
      "args": [
        "-y",
        "@zpup/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zpup": {
      "command": "npx",
      "args": [
        "-y",
        "@zpup/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zpup": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zpup/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zpup": {
      "command": "npx",
      "args": [
        "-y",
        "@zpup/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zpup": {
      "command": "npx",
      "args": [
        "-y",
        "@zpup/mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [AI Photo Editor MCP](https://ai-powered.com/mcp/ai-photo-editor-mcp): AI Photo Editor MCP is an open-source MCP server for design and media.
- [SceneView](https://ai-powered.com/mcp/sceneview-2): SceneView is an open-source MCP server for developer tools.
- [Figma To Code MCP](https://ai-powered.com/mcp/figma-to-code-mcp): Figma To Code MCP is an open-source MCP server for design and media.
- [MCP Server Template](https://ai-powered.com/mcp/mcp-server-template): MCP Server Template is an open-source MCP server for developer tools.
- [paprika3d (three.js games and 3D pages end to end, for coding agents)](https://ai-powered.com/mcp/paprika3d-three-js-games-and-3d-pages-end-to-end-for-coding): paprika3d (three.js games and 3D pages end to end, for coding agents) is an MCP server for design and media.
- [ryudi84](https://ai-powered.com/mcp/ryudi84-2): ryudi84 is an open-source MCP server for developer tools.
- [AVIZ](https://ai-powered.com/mcp/aviz): AVIZ is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/zpup
