mcp_三维地形

Name: mcp_三维地形
Author: Bigchx

作者：Bigchx11 星标更新：2025-04-27

项目介绍

</div>

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

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

{
  "mcpServers": {
    "mcp_3d_relief": {
      "command": "uv",
      "args": ["--directory", "{填入你的路径}", "run", "server.py"]
    }
  }
}

image_path：输入图像文件的本地路径或网络URL
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时，图像将以320像素的分辨率进行处理，通常生成的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"
}

LLMs可以从这个MCP服务器访问生成的文件，使用提供的URL。

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

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

为了生成更高品质的深度图，你可以使用外部深度图生成服务，如Depth-Anything-V2。该服务可以生成更准确的深度图，然后你可以将其与本项目一起使用：

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