MCP 3d Relief

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

このプロジェクトは、2D画像をSTL形式の3Dレリーフモデルに変換するMCPサーバーを提供します。このモデルは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は、このMCPサーバーから生成されたファイルに、提供されたURLを使用してアクセスできます。

コマンドライン

コマンドラインから直接スクリプトを使用して、画像からレリーフモデルを生成することもできます：

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>