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