Advertise
MCP.so
Sign In

MCP 3d Relief

@Bigchx

Repository

Basic information

Category

Other

Transports

stdio

Author

Bigchx

Submitted by

Sober

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

MCP 3d Relief 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"
      ]
    }
  }
}

MCP 3d Relief tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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

Comments

More Other MCP servers

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

ICSS

chokcoco

不止于 CSS

20.7K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Advertise