MCP 3d relief

MCP STL 3D浮雕生成器

中文 · MCP简介 · 维基

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

特性

• 将任何图像转换为3D浮雕模型
• 控制模型尺寸（宽度、厚度）
• 将可选基座添加到3D模型中
• 反转深度以获得不同的浮雕效果
• 通过即时下载链接快速处理

安装

先决条件

• Python 3.10+
• 紫外线

选项1：本地安装

1. 克隆存储库：

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

1. 安装依赖项：

uv pip sync requirements.txt

1. 运行/检查服务器：

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：输入图像文件的本地路径或web URL
• model_width：三维模型的宽度（mm）（默认值：50.0）
• model_thickness：3D模型的最大厚度/高度（mm）（默认值：5.0）
• base_thickness：基座厚度（mm）（默认值：2.0）
• skip_depth：是直接使用图像还是生成深度图（默认值：true）
• invert_depth：反转浮雕（明亮区域变低而不是变高）（默认值：false）
• detail_level：控制处理后图像的分辨率（默认值：1.0）。在detail_level=1.0时，图像以320px的分辨率进行处理，生成通常低于100MB的STL文件。较高的值可以提高细节质量，但会显著增加处理时间和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

外部深度图生成

对于更高质量的深度图，您可以使用外部深度图生成服务，如 深度-任何东西-V2。此服务可以生成更精确的深度图，然后您可以将其用于此项目：

1. 访问 https://huggingface.co/spaces/depth-anything/Depth-Anything-V2
2. 上传图像以生成深度图
3. 下载生成的深度图
4. 通过设置将此深度图与我们的转换器一起使用 skip_depth=false

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

运作原理

1. 处理图像以创建深度图（较暗像素=较低，较亮像素=较高）
2. 深度图转换为具有三角形小平面的3D网格
3. 模型底部添加了一个基座
4. 模型保存为STL文件

我们的合作伙伴