mcp_3d_relief

MCP STL 3D 릴리프 생성기

中文· MCP 소개 · Wiki

이 프로젝트는 2D 이미지를 3D 인쇄나 렌더링에 적합한 STL 형식의 3D 릴리프 모델로 변환하는 MCP 서버를 제공합니다.

특징

• 모든 이미지를 3D 릴리프 모델로 변환
• 제어 모델 치수(폭, 두께)
• 3D 모델에 선택적 기반 추가
• 다양한 릴리프 효과를 위해 깊이를 반전합니다.
• 즉시 다운로드 링크로 빠른 처리

설치

필수 조건

• 파이썬 3.10+
• 자외선

옵션 1: 로컬 설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 서버 실행/검사:

용법

JSON 구성

MCP 도구 매개변수

• image_path : 입력 이미지 파일에 대한 로컬 경로 또는 웹 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을 두 배로 높이면 파일 크기가 4배 이상 증가할 수 있습니다. 주의해서 사용하세요.

응답

MCP 도구는 다음을 포함하는 JSON 응답을 반환합니다.

LLM은 제공된 URL을 사용하여 이 MCP 서버에서 생성된 파일에 액세스할 수 있습니다.

명령줄

명령줄에서 직접 스크립트를 사용하여 이미지에서 릴리프 모델을 생성할 수도 있습니다.

외부 깊이 맵 생성

더 높은 품질의 깊이 맵을 원하시면 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 파일로 저장됩니다.

우리의 파트너들