라이노MCP
RhinoMCP는 Model Context Protocol(MCP)을 통해 Rhino3D를 Claude AI에 연결하여 Claude가 AI 지원 3D 모델링, 분석 및 설계 워크플로를 위해 Rhino3D와 직접 상호 작용하고 제어할 수 있도록 합니다.
프로젝트 개요
이 통합은 두 가지 주요 구성 요소로 구성됩니다.
- Rhino 플러그인 : Rhino의 Python 편집기 내부에서 실행되는 소켓 서버로, Rhino 기능과의 통신 인터페이스를 제공합니다.
- MCP 서버 : Claude AI를 Rhino 플러그인에 연결하여 AI 제어 작업을 가능하게 하는 모델 컨텍스트 프로토콜의 구현입니다.
특징
- Python과 Rhino 간의 소켓 기반 양방향 통신
- Claude AI 통합을 위한 모델 컨텍스트 프로토콜 서버
- NURBS 곡선 생성 지원(초기 테스트 기능)
- Rhino 컨텍스트 내에서 Python 스크립트 실행
- Claude Desktop과 Windsurf 모두 클라이언트로 호환 가능
설치
요구 사항
- Rhinoceros 3D(버전 7 또는 8)
- Python 3.10 이상
- 윈도우 10 또는 11
uv를 사용하여 설치(권장)
지엑스피1
pip를 사용하여 설치
# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate # On Windows
# Install the package
pip install -e .
용법
1단계: Rhino Bridge 서버 시작
- 오픈 라이노
- 명령줄에
EditPythonScript 입력하여 Rhino의 Python 편집기를 엽니다. src/rhino_plugin/rhino_server.py 에서 Rhino 서버 스크립트를 엽니다.- 스크립트를 실행합니다(F5 또는 실행 버튼을 클릭합니다)
- 출력 패널에 "Rhino Bridge가 시작되었습니다!"라는 메시지가 표시되는지 확인하세요.
2단계: MCP 서버 시작
# Activate your virtual environment
source .venv/Scripts/activate # On Windows with Git Bash
# Start the MCP server
rhinomcp
또는 사용자 정의 설정으로 실행:
rhinomcp --host 127.0.0.1 --port 5000 --rhino-host 127.0.0.1 --rhino-port 8888 --debug
3단계: Claude Desktop 또는 Windsurf에 연결
Claude Desktop 또는 Windsurf를 구성하여 다음 위치에서 MCP 서버에 연결합니다.
예: NURBS 곡선 생성
Claude에 연결하면 다음과 같은 프롬프트를 사용하여 Rhino에서 NURBS 곡선을 생성하도록 요청할 수 있습니다.
Create a NURBS curve in Rhino using points at (0,0,0), (5,10,0), (10,0,0), and (15,10,0).
개발
개발 환경 설정
# Clone the repository
git clone https://github.com/FernandoMaytorena/RhinoMCP.git
cd RhinoMCP
# Create and activate virtual environment
uv venv .venv
source .venv/Scripts/activate # On Windows with Git Bash
# Install development dependencies
uv pip install -e ".[dev]"
테스트 실행
코드 스타일
이 프로젝트에서는 린팅과 포맷팅에 Ruff를 사용합니다.
ruff check .
ruff format .
프로젝트 구조
RhinoMCP/
├── src/
│ ├── rhino_plugin/ # Code that runs inside Rhino
│ │ └── rhino_server.py
│ └── rhino_mcp/ # MCP server implementation
│ ├── rhino_client.py
│ └── mcp_server.py
├── tests/ # Test modules
├── docs/ # Documentation
├── config/ # Configuration files
├── ai/ # AI documentation and prompts
├── setup.py # Package installation
├── requirements.txt # Package dependencies
└── README.md # Project documentation
특허
MIT 라이센스
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.