Mcp_3d_relief

MCP STL 3D レリーフジェネレーター

このプロジェクトは、2D 画像を STL 形式の 3D レリーフモデルに変換する MCP サーバーを提供します。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：入力画像ファイルのローカルパスまたは Web URL
• model_width：3D モデルの幅（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 を 2 倍にすると、ファイルサイズが 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 などの外部深度マップ生成サービスを利用できます。このサービスでより正確な深度マップを生成し、このプロジェクトで使用できます：

1. https://huggingface.co/spaces/depth-anything/Depth-Anything-V2 にアクセスします
2. 画像をアップロードして深度マップを生成します
3. 生成された深度マップをダウンロードします
4. skip_depth=false に設定して、この深度マップをコンバーターで使用します

この方法では、特に複雑な画像の場合、より優れた 3D レリーフモデルを作成できます。

仕組み

1. 画像を処理して深度マップを作成します（暗いピクセルは低く、明るいピクセルは高くなります）
2. 深度マップを三角形の面で構成される 3D メッシュに変換します
3. モデルの底面にベースを追加します
4. モデルを STL ファイルとして保存します

Our partners