라이노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 서버에 연결합니다.

ws://127.0.0.1:5000

예: 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]"

테스트 실행

pytest

코드 스타일

이 프로젝트에서는 린팅과 포맷팅에 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 라이센스

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

Integrations