Mcp_3d_relief

Name: Mcp_3d_relief
Author: Bigchx

@Bigchx

About Mcp_3d_relief

This project provides a MCP server that converts 2D images into 3D relief models in STL format, suitable for 3D printing or rendering.

#3d #relief #stl

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp_3d_relief?

Mcp_3d_relief is a Model Context Protocol server that converts 2D images into 3D relief models in STL format. It is designed for makers, designers, and hobbyists who need to generate dimensional reliefs from photographs or graphics for 3D printing, CNC routing, or visualization.

How to use Mcp_3d_relief?

Install the MCP server and configure it with the tool parameters. Invoke the tool by providing an image_path (local file or web URL) along with optional parameters for model dimensions, base thickness, and detail level. The server returns a JSON response containing paths to the generated depth map and STL file. Alternatively, you can use the included Python script directly from the command line: python3 relief.py path/to/your/image.jpg.

Key features of Mcp_3d_relief

Converts images to 3D relief models in STL format
Customizable model width, thickness, and base thickness (in mm)
Adjustable detail level to control resolution and file size
Option to invert or skip depth map generation
Supports external depth maps for higher quality results
Can be used as an MCP tool or standalone command-line script

Use cases of Mcp_3d_relief

Create custom 3D printable reliefs from personal photographs
Generate base models for CNC carving or engraving projects
Produce architectural or topographic reliefs from maps or patterns
Integrate image-to-3D conversion into AI-assisted design workflows

FAQ from Mcp_3d_relief

What parameters control the size of the 3D model?

You can set model_width (default 50.0 mm), model_thickness (default 5.0 mm), and base_thickness (default 2.0 mm) to define the physical dimensions of the relief.

How does the detail_level parameter affect output?

detail_level controls the resolution during processing. At the default of 1.0, the image is processed at 320px, producing STL files typically under 100MB. Higher values improve detail but can increase file size by 4× or more and significantly lengthen processing time.

Can I use an external depth map instead of the built-in one?

Yes. Set skip_depth=false and provide a depth map generated by an external service (e.g., Depth-Anything-V2). This can produce more accurate 3D reliefs, especially for complex images.

What output does the MCP tool return?

The tool returns a JSON object with status, depth_map_path (path to the generated depth map PNG), and stl_path (path to the STL file). The LLM can access these files using the provided URLs.

How do I run relief generation from the command line?

Use the Python script directly: python3 relief.py path/to/your/image.jpg. Additional parameters can be passed as command-line arguments (see the script's help for details).