MIT License
MCP STL 3D 浮雕生成器
该项目提供了一个 MCP 服务器，可将 2D 图像转换为 STL 格式的 3D 浮雕模型，适用于 3D 打印或渲染。
特征
将任何图像转换为 3D 浮雕模型
控制模型尺寸（宽度、厚度）
向 3D 模型添加可选基础
不同地形效果的反转深度
快速处理并立即下载链接
安装
先决条件
Python 3.10+
选项 1：本地安装
克隆存储库：
git clone https://github.com/bigchx/mcp_3d_relief.git
cd mcp_3d_relief
安装依赖项：
uv pip sync requirements.txt
运行/检查服务器：
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 。此服务可以生成更精确的深度图，您可以将其用于以下项目：
访问https://huggingface.co/spaces/depth-anything/Depth-Anything-V2
上传图像以生成深度图
下载生成的深度图
通过设置
skip_depth=false将此深度图与我们的转换器一起使用
这种方法可以提供更好的 3D 浮雕模型，特别是对于复杂的图像。
工作原理
对图像进行处理以创建深度图（较暗的像素=较低，较亮的像素=较高）
深度图转换为具有三角面片的 3D 网格
在模型底部添加底座
模型保存为 STL 文件