Mcp_3d_relief

Created By

Bigchxa year ago

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

Overview Content Tools Comments

Content

MCP Tool Parameters

image_path: Local path or web URL to the input image file
model_width: Width of the 3D model in mm (default: 50.0)
model_thickness: Maximum thickness/height of the 3D model in mm (default: 5.0)
base_thickness: Thickness of the base in mm (default: 2.0)
skip_depth: Whether to use the image directly or generate a depth map (default: true)
invert_depth: Invert the relief (bright areas become low instead of high) (default: false)
detail_level: Controls the resolution of the processed image (default: 1.0). At detail_level = 1.0, the image is processed at 320px resolution, producing an STL file typically under 100MB. Higher values improve detail quality but significantly increase both processing time and STL file size. For example, doubling the detail_level can increase file size by 4x or more. Use with caution.

Response

The MCP Tool returns a JSON response with:

{
  "status": "success",
  "depth_map_path": "path/to/yourimage_depth_map.png",
  "stl_path": "path/to/yourimage.stl"
}

Where LLMs can access the generated files from this MCP server, using the provided URLs.

Command Line

You can also use the script directly from the command line to generate a relief model from an image:

python3 relief.py path/to/your/image.jpg

External Depth Map Generation

For higher quality depth maps, you can use external depth map generation services like Depth-Anything-V2. This service can generate more accurate depth maps that you can then use with this project:

Visit https://huggingface.co/spaces/depth-anything/Depth-Anything-V2
Upload your image to generate a depth map
Download the generated depth map
Use this depth map with our converter by setting skip_depth=false

This approach can provide better 3D relief models, especially for complex images.

Server Config

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Playwright McpPlaywright MCP server

DeepChatYour AI Partner on Desktop

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

Amap Maps高德地图官方 MCP Server

ChatWiseThe second fastest AI chatbot™

Serper MCP ServerA Serper MCP Server

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Tavily Mcp

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。