jingcheng-chen/rhinomcp

RhinoMCP – AI 기반 Rhino 3D 및 Grasshopper 제어

무엇인가요 – 대규모 언어 모델 에이전트(Claude, Cursor, Codex 등)가 Rhino 3D와 시각 프로그래밍 환경인 Grasshopper와 통신할 수 있도록 해주는 소규모 오픈소스 브리지입니다. Model Context Protocol(MCP)를 구현하여 AI가 자연어로 고수준 명령을 내리고 Rhino 뷰포트에서 시각 피드백을 받을 수 있도록 합니다.

주요 기능

• 기하학 생성 및 편집 – 점, 곡선, 표면, 솔리드, 불리안 연산, 로프트, 스위프트 등 하나씩 또는 일괄 처리 가능.
• 장면 검사 – 객체 목록, 속성, 레이어를 질의하거나 현재 뷰포트의 스크린샷을 캡처하여 모델이 "보는" 것처럼 활용 가능.
• Grasshopper 스크립팅 – 컴포넌트 검색, 캔버스에 추가, 파라미터 연결, 슬라이더 값 설정, 솔버 실행, 또는 단일 호출로 전체 정의 재구성 가능.
• 저수준 접근 – 어떤 네이티브 Rhino 명령어든 실행 가능, RhinoScript-Python 실행, RhinoCommon C# 코드 실행 (강력한 도구를 비활성화할 수 있는 옵션 포함).
• 양방향 상호작용 – AI는 기하학을 생성할 뿐만 아니라 모델 상태를 읽어내어 반복적인 디자인 루프를 가능하게 합니다.

작동 방식

1. Python MCP 서버 (rhinomcp on PyPI)를 로컬에서 실행하고 표준 MCP stdio 인터페이스를 통해 도구 세트를 노출합니다.
2. Rhino 플러그인 (Rhino의 패키지 매니저를 통해 설치)가 Rhino 내부에 TCP 리스너를 시작합니다 (기본값 127.0.0.1:1999).
3. AI 클라이언트가 서버를 MCP 엔드포인트(rhino)로 등록하고 JSON 인코딩된 도구 호출을 전송합니다. 플러그인이 메인 Rhino 스레드에서 이를 실행하고 결과를 반환합니다.

시작하기

1. 패키지 매니저에서 Rhino 플러그인을 설치 (rhinomcp).
2. uvx rhinomcp@latest로 Python 서버를 설치 (또는 pip install rhinomcp).
3. 서버를 AI 클라이언트의 MCP 설정에 추가 (예: codex mcp add rhino …).
4. Rhino에서 mcpstart 명령을 실행하여 TCP 브리지 열기.
5. 어시스턴트와 대화: "파란색에서 빨간색으로 그라데이션되는 6×6×6 박스 그리드를 만들고" 또는 "점으로부터의 거리에 따라 높이가 변하는 원통을 배치하는 Grasshopper 그래프를 만들고"와 같이 요청하세요.

대상 사용자 – 이미 Rhino 8을 사용하고 있으며 AI 지원 모델링이나 Grasshopper 워크플로우 자동화를 실험하고자 하는 디자이너, 건축가, 엔지니어, 개발자. 또한 자율 설계 에이전트를 개발하는 연구자에게도 유용합니다.

프로젝트 상태 – 활발히 유지 관리 중 (PyPI 릴리스, 패키지 매니저를 통한 Rhino 플러그인 업데이트). 리포지토리는 Python 테스트 세트, C# 빌드 스크립트, 도구 세트 확장용 문서를 포함합니다.

라이선스 – MIT.