Rhino3d

🚀 RhinoMCP

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

🚀 Quick Start

Prerequisites

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

Installation

Using uv (Recommended)

# Create and activate a virtual environment
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # For Windows Git Bash
# Install the package
uv pip install -e .

Using pip

# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate  # For Windows
# Install the package
pip install -e .

Usage

Step 1: Start the Rhino Bridge Server

1. Open Rhino.
2. Enter 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 (Press F5 or click the "Run" button).
5. Confirm that you see "Rhino Bridge has been started!" in the output panel.

Step 2: Start the MCP Server

# Activate your virtual environment
source .venv/Scripts/activate  # For Windows 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: Create a NURBS Curve

After connecting with Claude, you can request it to create a NURBS curve in Rhino using the following prompt:

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

✨ Features

• Socket-based bidirectional communication for interaction between Python and Rhino.
• Support for integrating Claude AI with the Rhino plugin via the MCP protocol.
• Support for NURBS curve creation (initial testing feature).
• Ability to execute Python scripts within the Rhino context.
• Compatibility with Claude Desktop and Windsurf as clients.

📦 Installation

Requirements

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

Using uv (Recommended)

# Create and activate a virtual environment
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # For Windows Git Bash
# Install the package
uv pip install -e .

Using pip

# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate  # For Windows
# Install the package
pip install -e .

💻 Usage Examples

Basic Usage

The basic usage process is described in the "🚀 Quick Start" section above.

Advanced Usage

You can run the MCP server with custom settings:

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

📚 Documentation

Project Overview

This integration consists of two main components:

1. Rhino Plugin: A socket server running inside Rhino's Python editor, providing a communication interface with Rhino's functions.
2. MCP Server: A server implementing the Model Context Protocol (MCP), connecting Claude AI to the Rhino plugin for AI-controlled operations.

Development

Set up the Development Environment

# Clone the repository
git clone https://github.com/FernandoMaytorena/RhinoMCP.git
cd RhinoMCP
# Create and activate a virtual environment
mkdir -p .venv
python -m venv .venv
source .venv/Scripts/activate  # For Windows Git Bash
# Install dependencies
pip install -r requirements.txt
# Run tests
pytest tests/

Project Structure

RhinoMCP/
├── src/
│   ├── rhino_plugin/       # Rhino plugin code
│   └── mcp_server/        # MCP server code
├── requirements.txt      # Project dependency list
└── README.md             # Project documentation

Contribution

We welcome contributions from the community! Please refer to CONTRIBUTING.md to learn how to get involved.

📄 License

This project is licensed under the MIT License.