Rhino MCP

Codex, Claude, Cursor를 위한 마찰 없는 Rhino 및 Grasshopper 브리지입니다.

Windows 환경에서의 사용법은 의도적으로 간단합니다:

1. RhinoMCP-Windows-Setup을 다운로드하여 실행합니다.

2. Codex, Claude, Cursor 중 하나를 선택합니다.

3. Rhino를 열고 Grasshopper를 연 다음 프롬프트를 시작합니다.

일반적인 설정 과정에는 Rhino 패키지 관리자, 저장소 복제, Python 설치, uv, Conda 환경, Rhino Python 스크립트, Grasshopper 파일, Python 경로 변경, 터미널 명령, 수동으로 편집한 MCP 구성이 포함되지 않습니다.

설치

Rhino 8.0 이상과 사용하려는 AI 클라이언트가 필요합니다. Rhino 8.1은 Rhino를 업데이트하지 않고도 지원됩니다. Rhino를 닫고 최신 릴리스에서 단일 RhinoMCP-Windows-Setup-*.exe 파일을 다운로드한 후 더블클릭합니다. 설치 프로그램이 AI 클라이언트를 묻고 자동으로 다음을 수행합니다:

• Rhino에 번들된 설치 프로그램을 사용하여 Rhino 및 Grasshopper 브리지를 설치합니다.

• 완전한 런타임을 포함하는 자체 포함 MCP 서버를 설치합니다.

• Codex, Claude 또는 Cursor MCP 항목을 안전하게 작성합니다.

• 안전한 Grasshopper 도구 프로필을 선택합니다.

• doctor 검사를 실행합니다.

• Windows 설치된 앱에 일반 항목을 추가하여 깨끗하게 제거할 수 있게 합니다.

설치 프로그램은 Rhino가 온라인 상태일 필요가 없으며 종속성을 다운로드하지 않으며 Rhino MCP는 자체적으로 업데이트되지 않습니다. 다른 버전을 설치하려면 항상 다른 설치 프로그램을 의도적으로 실행해야 합니다.

Rhino가 시작되면 Windows 기본 브라우저에서 로컬 연결 대시보드가 자동으로 열립니다. 인터넷 연결 없이 작동하며 별도의 앱, 서비스 또는 브라우저 확장 프로그램이 필요하지 않습니다.

Related MCP server: Grasshopper MCP

아키텍처 규정 검사

Rhino MCP에는 제공된 Google Drive 규정 라이브러리에서 구축된 컴팩트한 오프라인 검색 인덱스가 포함되어 있습니다. 원본 파일은 이 공개 소스 저장소 외부에 보존되며, 번들된 인덱스는 검색 가능한 페이지 텍스트, 소스 메타데이터 및 원본에 대한 링크를 저장합니다. 고정된 스냅샷이며 동기화되거나 업데이트되지 않습니다. 스냅샷에는 289개의 소스 파일이 포함되어 있으며, 272개의 검색 가능한 문서와 7,896개의 인덱스된 페이지가 있습니다. 아제르바이잔어, 러시아어, 영어 OCR로 553개의 스캔된 PDF 페이지와 66개의 이미지/TIFF 시트를 추출 오류 없이 복구했습니다.

건축, 건물, 접근성, 화재 안전, 구조, 위생, 에너지, 배수, 대피소, 부지 계획 또는 관련 Grasshopper 요청에 대해 모든 MCP 클라이언트는 항상 켜져 있는 워크플로 지침을 받습니다:

1. 관할권, 점유/프로젝트 유형, 설계 단계 및 제약 조건을 설정합니다.

2. 규제 치수를 제안하거나 모델을 편집하기 전에 규제 라이브러리를 검색합니다.

3. 각 요구 사항에 대해 정확한 문서 제목, Drive 소스 ID 및 페이지를 인용합니다.

4. 검증된 소스 요구 사항을 권장 사항 및 추론과 분리합니다.

5. 누락된 증거, 충돌, 불확실한 적용 가능성 및 공인된 현지 검토의 필요성을 표시합니다.

문서 텍스트는 신뢰할 수 없는 참조 데이터로 취급되며 실행 가능한 지침이 아닙니다. AI는 코드 값을 발명하거나 검토를 허가, 승인 또는 법적 준수 인증서로 설명해서는 안 됩니다.

항상 사용 가능한 규정 도구는 다음과 같습니다:

• regulation_library_status

• search_regulations

• get_regulation_page

• architecture_regulation_checklist

검색은 일반적인 영어 건축 용어를 아제르바이잔어와 러시아어로 확장하여 모델이 다국어 소스 자료를 찾을 수 있게 합니다. 설치된 스냅샷을 확인하거나 다음으로 검색을 시도하세요:

rhino-mcp regulations status
rhino-mcp regulations search "fire evacuation stairs"

소스 컬렉션과 그 유효한 법적 지위는 독립적으로 인증되지 않았습니다. 책임 있는 건축가 또는 엔지니어는 시공 전에 관할권, 적용 가능성, 수정 사항, 충돌 및 현재 요구 사항을 확인해야 합니다.

관리 또는 무인 배포의 경우 동일한 다운로드가 다음을 지원합니다:

.\RhinoMCP-Windows-Setup-0.4.2.exe /CLIENT=codex /SILENT

유효한 클라이언트 값은 codex, claude, cursor입니다. 설정 후 선택한 AI 클라이언트를 다시 시작하세요. Codex 사용자는 /mcp를 실행하여 rhino-mcp가 활성화되었는지 확인할 수 있습니다.

연결 대시보드

Rhino가 시작될 때마다 Rhino MCP는 Windows 기본 브라우저에서 하나의 대시보드 탭을 엽니다. 사용자가 선택한 브라우저를 사용하며 Chrome은 필요하지 않습니다. 페이지에는 다음의 실시간 상태가 표시됩니다:

• Rhino Bridge — 연결됨 또는 중지됨

• Codex / Claude / Cursor — 연결됨, 대기 중 또는 구성되지 않음

• Grasshopper — 연결됨 또는 열리지 않음

• Regulations — 로드됨 또는 설치되지 않음

페이지는 1초마다 상태를 새로 고칩니다. Rhino가 닫히면 기존 탭이 Rhino is offline으로 변경되고 계속 시도합니다. Rhino가 다시 열리면 자동으로 다시 연결됩니다. 탭은 언제든지 닫을 수 있습니다. Rhino에서 RhinoMCPDashboard를 실행하여 다시 열 수 있습니다.

기본 주소는 http://127.0.0.1:9877/입니다. Rhino 플러그인에서 직접 제공되며 이 컴퓨터에만 바인딩되고 읽기 전용이며 웹 자산을 로드하지 않고 인터넷으로 아무것도 보내지 않습니다. 해당 포트가 이미 사용 중이면 Rhino MCP는 자동으로 개인 로컬 대체 포트를 선택하고 올바른 주소를 엽니다.

Rhino에 표시되는 내용

Rhino MCP 연결 스트립은 Rhino가 시작될 때마다 활성 모델링 뷰포트의 오른쪽 상단에 자동으로 나타납니다. 측면 패널 공간을 차지하지 않고 계속 표시되며 활성 뷰포트를 따르고 이전 세션에서 숨겨졌더라도 다음 Rhino 시작 시 다시 나타납니다.

헤드라인은 CONNECTED — READY, WAITING FOR CODEX/CLAUDE/CURSOR, SETUP NEEDED 또는 BRIDGE STOPPED를 표시합니다. 네 개의 실시간 점이 표시됩니다:

• Bridge — Rhino가 수신 중일 때 녹색

• Codex / Claude / Cursor — 선택한 AI 클라이언트가 연결되었을 때 녹색

• Grasshopper — Grasshopper가 열려 있고 브리지를 사용할 수 있을 때 녹색

• Rules — 오프라인 규제 라이브러리가 로드되었을 때 녹색

스트립은 의도적으로 AI에 반환되는 뷰포트 이미지에 포함되지 않습니다. RhinoMCP를 실행하여 숨기거나 표시할 수 있습니다. 문제 해결을 위해 Rhino는 다음도 제공합니다:

• RhinoMCPDashboard — 브라우저 대시보드 다시 열기

• RhinoMCPStatus — 스트립 표시 및 전체 상태, 포트, 대시보드 URL 출력

• RhinoMCPRestart — 로컬 Rhino 브리지 다시 시작

• RhinoMCPTest — 테스트 큐브 생성, 확인 및 자동 제거

설치 프로그램에는 Rhino 8 런타임 빌드가 모두 포함되어 있습니다. Rhino는 일반 런타임에서 net7.0을 자동으로 사용하거나 Rhino가 레거시 .NET Framework 런타임으로 구성된 경우 net48을 사용합니다. 사용자가 선택하거나 구성할 필요는 없습니다.

연결 테스트는 1단위 큐브를 생성하고 확인한 후 제거합니다. 정리가 비활성화되면 테스트 큐브가 문서에 남습니다.

고급 명령

소스 및 Python 패키지 설치에서 다음을 사용할 수 있습니다:

rhino-mcp setup [codex|claude|cursor]
rhino-mcp doctor [--json]
rhino-mcp status [--json]
rhino-mcp update
rhino-mcp uninstall [--all]
rhino-mcp config [codex|claude|cursor]
rhino-mcp config --profile basic|grasshopper|developer

doctor는 패키지, 설정, 모든 AI 클라이언트, Rhino, Grasshopper 및 서버 실행기에 대한 통과/실패/대기 상태를 보고합니다. Rhino와 Grasshopper가 닫혀 있으면 소켓 추적 대신 정확한 다음 작업과 함께 WAIT로 표시됩니다.

도구 프로필

기본 (기본값)

안전한 일상 세트:

• rhino_status

• get_scene_summary

• list_layers

• list_objects

• get_scene_changes

• create_geometry

• modify_objects

• delete_objects

• organize_layers

• batch_geometry

• test_connection

• capture_viewport

Grasshopper

페이지 매김된 정의 컨텍스트, 선택/객체 검사 및 재계산 도구를 추가합니다. 번들된 .gha는 Grasshopper가 열릴 때 브리지를 자동으로 시작합니다. 로드할 .gh 정의나 Python 구성 요소는 없습니다.

개발자

임의의 Rhino 및 Grasshopper Python 도구를 명시적으로 추가합니다. 기본 및 Grasshopper 도구 스키마에는 없으므로 AI 클라이언트가 실수로 발견하거나 호출할 수 없습니다. 안전한 고급 작업이 여전히 선호됩니다.

안전한 편집 동작

• 모든 수정 요청에는 명명된 Rhino 실행 취소 레코드가 있습니다.

• 배치는 모든 작업을 하나의 트랜잭션으로 수행하고 한 번 다시 그립니다.

• 지오메트리 및 레이어 도구는 검증 및 미리 보기를 위해 dry_run: true를 허용합니다.

• 삭제에는 명시적인 Rhino 객체 ID가 필요합니다.

• 읽기 결과는 문자열 내부에 JSON으로 인코딩되지 않은 구조화된 객체입니다.

• 객체 및 Grasshopper 목록은 필터링되고 페이지 매김됩니다.

• get_scene_changes는 제공된 장면 버전 이후의 추가, 편집 및 삭제만 보냅니다.

예시 프롬프트:

Create a 10 × 8 × 3 box on a layer named Massing. Dry-run it first, then create it
and show me a compressed viewport capture.

안정성 및 성능

• 4바이트 길이 접두사 메시지가 이전의 거대한 수신 버퍼를 대체합니다.

• 요청은 64 MiB 하드 제한으로 64 KiB 청크로 읽습니다.

• Rhino TCP 및 Grasshopper HTTP 연결은 유지되고 재사용됩니다.

• 실패한 안전 읽기는 자동으로 한 번 다시 연결됩니다.

• 변형은 맹목적으로 재시도되지 않아 중복 지오메트리를 방지합니다.

• 수명이 짧은 장면 메타데이터는 캐시되고 편집 후 무효화됩니다.

• 장면 변경 및 대용량 문서는 전체를 반복적으로 반환하는 대신 페이지 매김됩니다.

• Grasshopper 컨텍스트는 기본적으로 단순화됩니다.

• 뷰 캡처는 기본적으로 압축된 JPEG이며 크기와 품질을 구성할 수 있습니다.

• 소켓 작업 및 이미지 인코딩은 Rhino의 UI 스레드에서 분리되어 실행됩니다. Rhino API 호출만 해당 스레드로 마샬링됩니다.

• 도구 설명과 일반 응답은 의도적으로 간결하여 모델 토큰 사용을 줄입니다.

이미지 기본값을 변경하려면:

rhino-mcp config --image-size 1280 --image-quality 82

개발자 빌드

Python 패키지:

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q
python -m build

Rhino 8 플러그인 및 패키지 관리자 아카이브:

./scripts/build-yak.sh Release

스크립트는 dist/ 아래에 RhinoMCP.rhp, RhinoMCP.Grasshopper.gha 및 .yak을 빌드합니다.

완전한 Windows 설치 프로그램 (Windows에서 PowerShell로 실행):

python -m pip install -e ".[dev]" "pyinstaller==6.22.2"
choco install innosetup --yes
.\scripts\build-windows-installer.ps1

CI는 번들된 Windows 실행 파일과 단일 파일 설치 프로그램을 컴파일하고 스모크 테스트합니다. 태그된 릴리스에는 설치 프로그램, SHA-256 체크섬 및 수동 개발자 아티팩트가 첨부됩니다.

아키텍처

Codex / Claude / Cursor
        │ MCP stdio
        ▼
bundled rhino-mcp.exe
        ├── offline regulation search index
        │
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + visible viewport status strip
        ├── read-only browser dashboard at 127.0.0.1
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

두 브리지와 대시보드는 127.0.0.1에만 바인딩됩니다. 네트워크에 노출되지 않습니다.

라이선스

MIT. 이 저장소는 독립형이며 업스트림 Git 원격이 없습니다.