MCP STL 3D 浮雕生成器

中文· MCP简介· Wiki

该项目提供了一个 MCP 服务器，可将 2D 图像转换为 STL 格式的 3D 浮雕模型，适用于 3D 打印或渲染。

特征

• 将任何图像转换为 3D 浮雕模型

• 控制模型尺寸（宽度、厚度）

• 向 3D 模型添加可选基础

• 不同地形效果的反转深度

• 快速处理并立即下载链接

Related MCP server: imagen3-mcp

安装

先决条件

• Python 3.10+

• 紫外线

选项 1：本地安装

1. 克隆存储库：

git clone https://github.com/bigchx/mcp_3d_relief.git
cd mcp_3d_relief

2. 安装依赖项：

uv pip sync requirements.txt

3. 运行/检查服务器：

mcp run server.py
mcp dev server.py

用法

JSON 配置

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

MCP 工具参数

• image_path ：输入图像文件的本地路径或网址

• model_width ：3D 模型的宽度（毫米）（默认值：50.0）

• model_thickness ：3D 模型的最大厚度/高度（毫米）（默认值：5.0）

• base_thickness ：底座厚度（毫米）（默认值：2.0）

• skip_depth ：是否直接使用图像或生成深度图（默认值：true）

• invert_depth ：反转浮雕（明亮区域变低而不是变高）（默认值：false）

• detail_level ：控制处理后图像的分辨率（默认值：1.0）。当 detail_level = 1.0 时，图像将以 320px 的分辨率进行处理，生成的 STL 文件通常小于 100MB。更高的值可以提高细节质量，但会显著增加处理时间和 STL 文件大小。例如，将 detail_level 加倍会导致文件大小增加 4 倍或更多。请谨慎使用。

回复

MCP 工具返回 JSON 响应，内容如下：

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

LLM 可以使用提供的 URL 从此 MCP 服务器访问生成的文件。

命令行

您还可以直接从命令行使用脚本从图像生成浮雕模型：

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

外部深度图生成

为了获得更高质量的深度图，您可以使用外部深度图生成服务，例如Depth-Anything-V2 。此服务可以生成更精确的深度图，您可以将其用于以下项目：

1. 访问https://huggingface.co/spaces/depth-anything/Depth-Anything-V2

2. 上传图像以生成深度图

3. 下载生成的深度图

4. 通过设置skip_depth=false将此深度图与我们的转换器一起使用

这种方法可以提供更好的 3D 浮雕模型，特别是对于复杂的图像。

工作原理

1. 对图像进行处理以创建深度图（较暗的像素=较低，较亮的像素=较高）

2. 深度图转换为具有三角面片的 3D 网格

3. 在模型底部添加底座

4. 模型保存为 STL 文件

我们的合作伙伴