MCP 3d Relief

🚀 MCP STL 3D浮雕生成器

本項目提供了一個MCP服務器，可將二維圖像轉換為STL格式的3D浮雕模型，適用於3D打印或渲染。

🚀 快速開始

MCP STL 3D浮雕生成器是一個強大的工具，能輕鬆將二維圖像轉換為可用於3D打印或渲染的STL格式3D浮雕模型。以下是快速開始使用該項目的相關介紹。

✨ 主要特性

• 可將任意圖像轉換為3D浮雕模型。
• 能夠控制模型的尺寸（寬度、厚度）。
• 可為3D模型添加可選的底座。
• 可反轉深度以實現不同的浮雕效果。
• 處理速度快，並提供即時下載鏈接。

📦 安裝指南

前提條件

• Python 3.10及以上版本。
• uv

選項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：輸入圖像文件的本地路徑或網絡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）可以通過提供的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文件。

我們的合作伙伴

</a>

</a>