MCP STL 3D Relief Generator

image to 3d relief STL models

python

17

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bigchx-mcp_3d_relief": {
      "command": "mcp",
      "args": [
        "run",
        "server.py"
      ]
    }
  }
}

You have a MCP server that converts 2D images into 3D relief STL models suitable for 3D printing or rendering. It lets you control model width and thickness, optionally add a base, invert depth for different relief effects, and download the resulting STL quickly after processing.

How to use

Run the MCP server locally and connect your client to generate 3D reliefs from images. You can start the server directly from your development environment and then submit an image along with desired parameters such as width, thickness, base, and depth handling. The server will return paths to the depth map and the final STL file, which you can download and print or render.

How to install

Prerequisites you need to install first:

Python 3.10+ and the MCP runtime tooling (uv) must be available on your system.

Install the server locally by following one of these approaches.

Option 1: Use the MCP command to run the server directly from the source file.

MCP server setup with the two available runtimes

{
  "mcpServers": {
    "mcp_3d_relief": {
      "command": "mcp",
      "args": ["run", "server.py"]
    },
    "relief_uv": {
      "command": "uv",
      "args": ["--directory", "{fill_in_your_path_here}", "run", "server.py"]
    }
  }
}

Available tools

convert_image_to_stl

Converts an input image into a 3D relief mesh and exports it as an STL file.

configure_dimensions

Sets the width and thickness of the resulting 3D model to fit printing requirements.

add_base

Optionally appends a base to the bottom of the relief model for stability in printing.

invert_depth

Inverts the relief depth so bright areas become low and dark areas become high, or vice versa.

generate_depth_map

Generates or processes a depth map from the input image to drive the 3D extrusion.