sodam-ai/SoDam-Rhino-MCP-Codex

Rhino 로 건축 3DM 모델을 생성·검증하고 Blender로 렌더링하는 로컬 MCP 도구

About SoDam-Rhino-MCP-Codex

English Markdown · 한국어 HTML · English HTML

한눈에 보기: 이 프로젝트는 건물의 위치·크기·종류를 적은 JSON에서 구성요소별 메시(mesh)가 들어 있는 .3dm 파일을 만들고, 이를 다시 읽어 검수하는 Windows용 로컬 도구입니다. Rhino 설치나 Rhino 라이선스는 필요하지 않습니다. 사진만 넣으면 정확한 3D가 자동 완성되는 제품은 아니며, Rhino의 모든 기능을 복제하지도 않습니다.

이 문서는 현재 이 폴더에 있는 코드를 설명합니다. 처음 컴퓨터를 쓰는 사람도 따라갈 수 있도록 클릭할 위치와 명령의 의미를 함께 적었습니다. 명령은 별도 표시가 없으면 Windows PowerShell에서 프로젝트 최상위 폴더를 연 상태로 실행합니다. 설명 기준일: 2026-09-25.

1. 먼저 알아둘 말과 지원 범위 2. 사전 준비물과 다운로드 3. 폴더 확인과 빠른 시작 4. Codex 또는 Claude Code에 설치 5. 실행과 실제 사용 순서 6. 명령어 모음 7. 사진 근거를 다루는 방법 8. Blender로 렌더하고 가져오기 9. 워크플로우와 아키텍처 10. 보안과 데이터 흐름 11. 파일과 문서 위치 12. 테스트와 현재 확인 상태 13. 독립 치수 평가 14. 업데이트 내용 15. 문제·오류 대처 16. 자주 묻는 질문 17. 저작권·라이선스·상업적 이용

- JSON: 건물 부품의 이름, 종류, 위치, 크기, 색과 근거를 글자로 저장한 설계 입력 파일입니다. 예제를 복사해 시작할 수 있습니다. - 3DM: Rhino 계열 파일 형식입니다. 여기서는 Rhino를 실행하지 않고 rhino3dm 라이브러리로 작성합니다. 저장된 객체는 이름·레이어·색·입력 제어값을 가집니다. - MCP: Codex나 Claude Code 같은 AI 호스트가 로컬 프로그램의 도구를 호출하는 연결 방식입니다. 스킬은 AI에게 작업 절차를 알려주는 지침이고, 실제 파일 생성은 이 프로젝트의 MCP 서버가 수행합니다. - Blender: 무료 3D 프로그램입니다. 기본 3DM 생성에는 필요하지 않지만 두 장의 재질 렌더와 편집 가능한 .blend, 기존 Blender 장면 가져오기에는 필요합니다. - 검수도: 저장한 3DM 메시에서 만든 직교 PNG입니다. Blender 렌더나 사진 일치 증명과 구별합니다.

지원하는 JSON 부품은 box(상자), wallopening(개구부 벽), gableroof(박공지붕), cylinder(원형 기둥) 네 가지입니다. 3DM 작성·재열기, 새 파일로 구성요소 수정, 두 시점 검수 PNG, 사진 근거 기록·감사, 선택적 Blender 왕복을 제공합니다. 복잡한 메시 형상은 신뢰할 수 있는 Blender 장면에서 가져올 수 있습니다.

지원하지 않는 것: 사진 한 장만으로 숨은 면·절대 치수를 정확히 알아내기, 자동 사진 카메라 맞춤, Rhino 화면 제어, Rhino 고유 NURBS/Boolean/솔리드 편집 기능, 3DM에 Rhino 이름 붙은 뷰 저장, 구조·법규·시공 적합성 판정. Blender에서 가져온 것은 메시이며 원본 .blend의 수정 이력·카메라·조명·노드 재질이 3DM에 그대로 보존되지는 않습니다. 자세한 대응표는 PARITY.md

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/sodam-ai--SoDam-Rhino-MCP-Codex.html)

Related MCP servers