MCP.so
登录

MCP 3d Relief

@Bigchx

基本信息

分类

其他

传输方式

stdio

作者

Bigchx

提交者

Sober

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP 3d Relief 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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

评论

其他 分类下的更多 MCP 服务器