Rhino3D

GitHub
Integrates with
Rhino3D, Rhinoceros 3D

RhinoMCP

RhinoMCP connects Rhino3D to Claude AI via the Model Context Protocol (MCP), enabling Claude to directly interact with and control Rhino3D for AI-assisted 3D modeling, analysis, and design workflows.

Project Overview

This integration consists of two main components:

  1. Rhino Plugin: A socket server that runs inside Rhino's Python editor, providing a communication interface to Rhino's functionality.
  2. MCP Server: An implementation of the Model Context Protocol that connects Claude AI to the Rhino plugin, enabling AI-controlled operations.

Features

  • Socket-based bidirectional communication between Python and Rhino
  • Model Context Protocol server for Claude AI integration
  • Support for NURBS curve creation (initial test feature)
  • Python script execution within Rhino's context
  • Compatible with both Claude Desktop and Windsurf as clients

Installation

Requirements

  • Rhinoceros 3D (Version 7 or 8)
  • Python 3.10 or higher
  • Windows 10 or 11

Install Using uv (Recommended)

## Create and activate a virtual environment 
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # On Windows with Git Bash

## Install the package
uv pip install -e .

Install Using pip

## Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate  # On Windows

## Install the package
pip install -e .

Usage

Step 1: Start the Rhino Bridge Server

  1. Open Rhino
  2. Type EditPythonScript in the command line to open Rhino's Python editor
  3. Open the Rhino server script from src/rhino_plugin/rhino_server.py
  4. Run the script (F5 or click the Run button)
  5. Verify you see "Rhino Bridge started!" in the output panel

Step 2: Start the MCP Server

## Activate your virtual environment
source .venv/Scripts/activate  # On Windows with Git Bash

## Start the MCP server
rhinomcp

Or run with custom settings:

rhinomcp --host 127.0.0.1 --port 5000 --rhino-host 127.0.0.1 --rhino-port 8888 --debug

Step 3: Connect with Claude Desktop or Windsurf

Configure Claude Desktop or Windsurf to connect to the MCP server at:

ws://127.0.0.1:5000

Example: Creating a NURBS Curve

When connected to Claude, you can ask it to create a NURBS curve in Rhino with a prompt like:

Create a NURBS curve in Rhino using points at (0,0,0), (5,10,0), (10,0,0), and (15,10,0).

Development

Setup Development Environment

## 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]"

Run Tests

pytest

Code Style

This project uses Ruff for linting and formatting:

ruff check .
ruff format .

Project Structure

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

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.