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는 자체 업데이트를 하지 않습니다. 다른 버전을 설치하려면 항상 다른 설치 프로그램을 의도적으로 실행해야 합니다.

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

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

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

Related MCP server: Grasshopper MCP

Rhino에 표시되는 내용

도킹 가능한 Rhino MCP 패널은 Rhino가 시작될 때마다 자동으로 열립니다. 사용자가 숨길 때까지 계속 표시되며, 해당 세션의 나머지 동안 숨겨진 상태로 유지되고 다음 Rhino 시작 시 다시 나타납니다. RhinoMCP 명령을 언제든지 실행하여 수동으로 표시하거나 숨길 수 있습니다.

패널은 Rhino의 일반 패널/헤더 스트립에 맞습니다. 헤드라인에는 연결됨 — Rhino에 프롬프트할 준비가 됨, Rhino MCP가 실행 중 — AI 클라이언트를 기다리는 중, 또는 실행 가능한 중지/구성되지 않음 메시지가 표시됩니다. 또한 다음을 표시합니다:

• MCP 서버 연결됨 또는 대기 중

• Rhino 브리지 연결됨 또는 중지됨

• Grasshopper 사용 가능 또는 실행 중이 아님

• 선택한 AI 클라이언트 및 도구 프로필

• Rhino 및 Grasshopper 포트

• 최근 로그

• 다시 시작, 테스트 큐브 만들기, doctor 명령 복사 버튼

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

연결 테스트는 1단위 큐브를 만들고, 확인하고, 제거합니다. 정리가 비활성화된 경우 테스트 큐브는 문서에 남습니다.

고급 명령

Rhino 패널의 doctor 명령 복사 버튼은 설치 프로그램 사용자를 위한 올바른 전체 경로를 복사합니다. 소스 및 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 KiB 청크로 제한된 크기로 읽히며 64 MiB 하드 제한이 있습니다.

• 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
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + dockable panel
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

두 브리지 모두 127.0.0.1에만 바인딩됩니다. 네트워크에 노출되지 않습니다.

라이선스

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