Skip to main content
Glama
rhino-mcp

rhino-mcp

Rhinoceros 3D & Grasshopper MCP Bridge 🦏

License: MIT Python 3.9+ Rhinoceros Grasshopper Ecosystem

A Model Context Protocol (MCP) server that connects AI assistants (Google Antigravity, Claude Desktop, Cursor) directly with Rhinoceros 3D and Grasshopper.

Built for architects, B.Arch students, and parametric designers, enabling AI agents to programmatically generate freeform NURBS geometry, evaluate Grasshopper definitions, manipulate layers, and capture viewport renderings.


⚑ Key Highlights

  • RhinoCommon & CPython 3 Support: Works with Rhino 7 (IronPython) and Rhino 8 (native CPython 3.9+).

  • Grasshopper Parametric Solving: Load .gh / .ghx definitions, feed dynamic slider parameters, compute solutions, and bake geometry into Rhino layers.

  • Live Fleet Registration: Automatically registers its dynamic port and PID with %LOCALAPPDATA%\AutodeskMCP\registry.json, enabling single-entry routing through autodesk-mcp.

  • Architecture & Freeform Tool Suite:

    • Document Inspection: Document units, layer hierarchies, object counts, active viewports.

    • 3D NURBS Primitives: Boxes, spheres, cylinders, curves, and lofts.

    • Grasshopper Solver: Automated parameter sweeps and optimization.

    • Viewport Capture: Real-time snapshot of shaded/rendered viewport encoded to base64.


Related MCP server: RhinoMCP

πŸš€ Quick Start

1. Installation

Run PowerShell installer:

.\install.ps1

Or copy rhino_mcp/ into your Rhino scripts directory: %APPDATA%\McNeel\Rhinoceros\scripts\

2. Running inside Rhino

In Rhino's command bar, run:

_-RunPythonScript "rhino_mcp/startup.py"

3. Routing via Master Gateway

When running, the autodesk-mcp Gateway auto-detects Rhino and routes rhino_* tools seamlessly.


πŸ› οΈ Tool Suite

Tool

Description

rhino_get_document_info

Retrieves active document name, units, layers, and viewports.

rhino_create_geometry

Constructs 3D primitives (box, sphere, cylinder, NURBS curve).

rhino_run_grasshopper

Executes a parametric Grasshopper definition with dynamic input parameters.

rhino_capture_viewport

Captures the active Rhino 3D viewport into base64 image.


πŸ“„ License

MIT License © 2026 Aaradhya Dev Tamrakar

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects Rhino and Grasshopper to Claude AI via the Model Context Protocol, enabling prompt-assisted 3D modeling, scene manipulation, and control through tools like object creation, layer management, and code execution.
      32
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI-powered 3D modeling in Rhino 8 through 135+ tools for geometry, transformations, booleans, layers, materials, and more, using natural language.
      7
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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