mcp_3d_relief

MCP STL 3D 浮雕生成器

中文· MCP简介· Wiki

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

特征

• 将任何图像转换为 3D 浮雕模型
• 控制模型尺寸（宽度、厚度）
• 向 3D 模型添加可选基础
• 不同地形效果的反转深度
• 快速处理并立即下载链接

安装

先决条件

• Python 3.10+
• 紫外线

选项 1：本地安装

1. 克隆存储库：

2. 安装依赖项：

3. 运行/检查服务器：

用法

JSON 配置

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 响应，内容如下：

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

命令行

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

外部深度图生成

为了获得更高质量的深度图，您可以使用外部深度图生成服务，例如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 文件

我们的合作伙伴