MCP.so
ログイン

MCP 3d Relief

@Bigchx

基本情報

カテゴリ

その他

トランスポート

stdio

作者

Bigchx

投稿者

Sober

MCP 3d Relief について

This project provides a MCP server that converts 2D images into 3D relief models in STL format, suitable for 3D printing or rendering.

#3d#relief#stl

MCP 3d Relief の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp_3d_relief": {
      "command": "uv",
      "args": [
        "--directory",
        "{fill_in_your_path_here}",
        "run",
        "server.py"
      ]
    }
  }
}

MCP 3d Relief のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Mcp_3d_relief?

Mcp_3d_relief is a Model Context Protocol server that converts 2D images into 3D relief models in STL format. It is designed for makers, designers, and hobbyists who need to generate dimensional reliefs from photographs or graphics for 3D printing, CNC routing, or visualization.

How to use Mcp_3d_relief?

Install the MCP server and configure it with the tool parameters. Invoke the tool by providing an image_path (local file or web URL) along with optional parameters for model dimensions, base thickness, and detail level. The server returns a JSON response containing paths to the generated depth map and STL file. Alternatively, you can use the included Python script directly from the command line: python3 relief.py path/to/your/image.jpg.

Key features of Mcp_3d_relief

  • Converts images to 3D relief models in STL format
  • Customizable model width, thickness, and base thickness (in mm)
  • Adjustable detail level to control resolution and file size
  • Option to invert or skip depth map generation
  • Supports external depth maps for higher quality results
  • Can be used as an MCP tool or standalone command-line script

Use cases of Mcp_3d_relief

  • Create custom 3D printable reliefs from personal photographs
  • Generate base models for CNC carving or engraving projects
  • Produce architectural or topographic reliefs from maps or patterns
  • Integrate image-to-3D conversion into AI-assisted design workflows

よくある質問

1

What parameters control the size of the 3D model?

You can set `model_width` (default 50.0 mm), `model_thickness` (default 5.0 mm), and `base_thickness` (default 2.0 mm) to define the physical dimensions of the relief.

2

How does the detail_level parameter affect output?

`detail_level` controls the resolution during processing. At the default of 1.0, the image is processed at 320px, producing STL files typically under 100MB. Higher values improve detail but can increase file size by 4× or more and significantly lengthen processing time.

3

Can I use an external depth map instead of the built-in one?

Yes. Set `skip_depth=false` and provide a depth map generated by an external service (e.g., Depth-Anything-V2). This can produce more accurate 3D reliefs, especially for complex images.

4

What output does the MCP tool return?

The tool returns a JSON object with `status`, `depth_map_path` (path to the generated depth map PNG), and `stl_path` (path to the STL file). The LLM can access these files using the provided URLs.

5

How do I run relief generation from the command line?

Use the Python script directly: `python3 relief.py path/to/your/image.jpg`. Additional parameters can be passed as command-line arguments (see the script's help for details).

コメント

「その他」の他のコンテンツ