Rhino AI MCP Server
Provides a live bidirectional bridge into McNeel Rhinoceros 3D, enabling inspection of document, layer, object, and viewport state; creation of parametric geometry; execution of Rhino commands and Python scripts; selection/deletion of objects; viewport screenshots; and acoustic RT60 calculations.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Rhino AI Model Context Protocol (MCP) Toolkit
A general-purpose Model Context Protocol (MCP) server and live bidirectional bridge for McNeel Rhinoceros 3D (Rhino 8 & 9).
Connect AI agent workflows—including Google Antigravity, Claude Desktop, Cursor, VS Code, and custom LLM orchestrators—directly to Rhino's geometry engine, active document state, and command pipeline.
Architecture
+-------------------------------------------------------+
| AI Agent / LLM Client |
| (Google Antigravity, Claude Desktop, Cursor, etc.) |
+-------------------------------------------------------+
|
stdio | (JSON-RPC 2.0 / MCP Protocol)
v
+-------------------------------------------------------+
| FastMCP Server (mcp_server.py) |
| - Tool discovery & schema generation |
| - Parameter validation (Pydantic) |
| - Client proxy (rhino_client.py) |
+-------------------------------------------------------+
|
HTTP | REST API (http://127.0.0.1:9888)
v
+-------------------------------------------------------+
| Rhino Live Agent Bridge (rhino_bridge.py) |
| - Embedded daemon running inside Rhino 8 / 9 |
| - Dispatches tasks to Rhino Main UI Thread |
| - Full access to RhinoCommon, rs, and RhinoDoc |
| - Headless standalone fallback mode (via rhino3dm) |
+-------------------------------------------------------+Related MCP server: Rhino MCP
Key Features
Live Bidirectional Bridge: Control Rhino in real time via an embedded daemon thread on port
9888.UI Thread Safety: All geometry and document operations execute safely on Rhino's main UI thread.
Document & Layer Inspection: Query model units, bounding boxes, viewports, layer hierarchies, colors, and visibility.
Object Filtering & Querying: Search and filter objects by layer, geometry type (
Brep,Curve,Mesh,SubD,Point), or selection state.Parametric Geometry Generation: Create parametric primitives (
box,cylinder,sphere,line,point) with a single tool call.Arbitrary Python Execution: Execute arbitrary Python code inside Rhino with pre-injected
Rhino,rg(Rhino.Geometry),rs(rhinoscriptsyntax), anddoc(RhinoDoc.ActiveDoc).Rhino Command Execution: Execute any native Rhino command string (e.g.,
_Circle,_ExtrudeCrv,_ZoomAll).Viewport Screenshot Capture: Capture high-resolution viewport screenshots and save them directly to disk.
Acoustic RT60 Calculator: Built-in Sabine and Eyring reverberation time calculations for architectural enclosures.
Standalone Emulation Mode: Operates outside Rhino via
rhino3dmfor automated testing, CI/CD, and offline development.
Quick Start
1. Installation
Clone the repository and install the dependencies in your Python environment (Python 3.9+ recommended):
git clone https://github.com/Ziad-Amr1/rhino-ai-mcp.git
cd rhino-ai-mcp
pip install -e .Or install using requirements.txt:
pip install -r requirements.txt2. Launch the Bridge Inside Rhino
To connect to a live Rhino session, run rhino_bridge.py inside Rhino:
Option A: Rhino Command Line (Fastest)
In Rhino's command bar, run:
-_RunPythonScript "C:\path\to\rhino-ai-mcp\rhino_bridge.py"Option B: Rhino ScriptEditor
Type
ScriptEditor(Rhino 8+) orEditPythonScript.Open
rhino_bridge.py.Press Run (
F5).
Option C: Auto-Start on Rhino Launch (Recommended)
In Rhino, open Options (
Tools > Optionsor typeOptions).Go to General > Command Lists.
Under Run these commands every time Rhino starts, add:
-_RunPythonScript "C:\path\to\rhino-ai-mcp\rhino_bridge.py"Click OK. The bridge will start automatically whenever Rhino opens.
3. Verify Connection
Check the connection from your terminal:
python test_connection.pyExpected output:
Testing connection to Rhino Live Bridge at http://127.0.0.1:9888...
[SUCCESS] Connected to Rhino Live Bridge!
Rhino Version: Rhino 8.x / 9.x
Document Name: Untitled.3dm
Unit System: Millimeters
Active View: Perspective
Objects: 0 (Selected: 0)
Layers: 1AI Client Configuration
Google Antigravity / Gemini CLI
Add the server to your ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"rhino": {
"command": "python",
"args": [
"C:/path/to/rhino-ai-mcp/mcp_server.py"
],
"env": {
"RHINO_BRIDGE_URL": "http://127.0.0.1:9888"
}
}
}
}Claude Desktop
Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"rhino": {
"command": "python",
"args": [
"C:/path/to/rhino-ai-mcp/mcp_server.py"
],
"env": {
"RHINO_BRIDGE_URL": "http://127.0.0.1:9888"
}
}
}
}Cursor
Add to your project's .cursor/mcp.json or global Cursor settings:
{
"mcpServers": {
"rhino": {
"command": "python",
"args": [
"${workspaceFolder}/mcp_server.py"
],
"env": {
"RHINO_BRIDGE_URL": "http://127.0.0.1:9888"
}
}
}
}MCP Tools Reference
Tool Name | Type | Description | Key Parameters |
| Read | Checks if Rhino bridge is online and returns document overview | — |
| Read | Retrieves unit system, tolerances, and active viewport | — |
| Read | Lists all layers with colors, visibility, and lock status | — |
| Read | Searches objects by layer, geometry type, or selection |
|
| Read | Returns GUIDs and metadata of currently selected objects | — |
| Write | Selects or deselects objects by GUID |
|
| Write | Deletes objects by GUID |
|
| Write | Creates parametric primitives ( |
|
| Write | Executes any native Rhino command string |
|
| Write | Runs Python script in Rhino with access to |
|
| Read | Captures a high-resolution screenshot of active viewport |
|
| Read | Computes room Sabine and Eyring reverberation time |
|
| Action | Opens Pachyderm Acoustic Simulation UI panel | — |
Python SDK Examples
The toolkit includes a lightweight Python client (rhino_client.py) that can be used directly in Python scripts:
from rhino_client import RhinoClient
client = RhinoClient()
# Check bridge status
status = client.get_status()
print(f"Connected: {status['status']}")
# Create a box
box = client.create_geometry("box", origin=[0, 0, 0], size=[20, 10, 5])
print("Created Box GUID:", box["created_ids"][0])
# Execute RhinoCommon code
res = client.execute_python("""
import rhinoscriptsyntax as rs
circle_id = rs.AddCircle([0, 0, 0], 25.0)
result = f"Circle GUID: {circle_id}"
""")
print(res["result"])Explore runnable examples in the examples/ folder:
01_check_connection.py— Connect and inspect document properties.02_create_geometry.py— Create parametric boxes, cylinders, and spheres.03_query_objects_and_layers.py— Query and filter layers and objects.04_run_rhino_python.py— Execute Python code dynamically inside Rhino.
Testing & Verification
Run the comprehensive end-to-end test suite:
python test_backend.pyThe test suite validates:
REST bridge connection and status checks.
Document metadata extraction.
Layer listing and hierarchy queries.
Object queries with filtering.
Parametric geometry creation and GUID tracking.
Object selection and retrieval.
Dynamic Python execution and output capture.
Rhino command line execution.
Viewport image capture.
Object deletion and cleanup.
FastMCP server async tool bindings.
Repository Structure
rhino-ai-mcp/
├── .gitignore # Excludes virtual environments, caches, and local archives
├── LICENSE # MIT License
├── README.md # Project documentation and setup guide
├── pyproject.toml # Standard Python packaging configuration
├── requirements.txt # Package dependencies
├── mcp_server.py # FastMCP Server (stdio JSON-RPC for AI clients)
├── rhino_bridge.py # Live bridge daemon (runs inside Rhino 8 / 9)
├── rhino_client.py # Python SDK & CLI client
├── run_backend.py # Standalone headless runner
├── test_backend.py # Comprehensive test suite (13/13 passing)
├── test_connection.py # Quick bridge connection check
├── test_rhino_exec.py # Python execution verification script
├── examples/ # Ready-to-run Python examples
│ ├── 01_check_connection.py
│ ├── 02_create_geometry.py
│ ├── 03_query_objects_and_layers.py
│ └── 04_run_rhino_python.py
└── mcp_schemas/ # Tool definitions and documentationContributing
Contributions are welcome! Please open an issue or submit a pull request for improvements, bug fixes, or new MCP tool integrations.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Copyright © 2026 Ziad Amr.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Related MCP Servers
- AlicenseCqualityBmaintenanceEnables Claude to drive Rhino 8 and Grasshopper for geometry creation, manipulation, and analysis via natural language.246292 PyPI9MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered 3D modeling in Rhino 8 through 135+ tools for geometry, transformations, booleans, layers, materials, and more, using natural language.7MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI clients such as Codex, Claude, and Cursor to control Rhino and Grasshopper through natural language, including creating and modifying geometry, managing layers, inspecting scenes, and running Grasshopper operations.MIT
- AlicenseBqualityDmaintenanceEnables AI agents to drive AutoCAD 2024+ and AutoCAD LT through live COM and AutoLISP engines, with support for headless DXF processing, ISO GD&T, P&ID drafting, and Rhino.Inside Grasshopper battery workflows.162MIT