Skip to main content
Glama
RhinoMCP

RhinoMCP

RhinoMCP: an MCP Server for Rhino 3D

105 tools for AI-driven 3D modeling, analysis, diagnostics, and Grasshopper integration via the Model Context Protocol.

RhinoMCP connects Claude to Rhino 3D through a comprehensive set of tools covering everything from basic primitives to advanced surface modeling (loft, sweep, revolve), boolean operations, mesh diagnostics, block management, and parametric design with Grasshopper.

Architecture

┌────────────────┐   stdio    ┌──────────────┐   TCP/JSON    ┌──────────────┐
│ Claude Desktop │◄──────────►│  rhino_mcp   │◄─────────────►│    Rhino 3D  │
│                │   (MCP)    │  (Python)    │  localhost:   │  listener.py │
│                │            │  server.py   │    9876       │  (inside     │
└────────────────┘            └──────────────┘               │   Rhino)     │
                                                             └──────────────┘

MCP Server (rhino_mcp/). Python package using FastMCP. Communicates with Claude via stdio and with Rhino via TCP.

Rhino Listener (rhino/listener.py). Python script that runs inside Rhino. Opens a TCP server, receives JSON commands, executes them using RhinoCommon/rhinoscriptsyntax, and returns results.

Related MCP server: revit-mcp

Capabilities

Geometry Creation (21 tools)

Tool

Description

create_point, create_points

Single or batch point creation

create_line, create_polyline

Lines and polylines

create_curve

Interpolated NURBS curves

create_circle, create_arc, create_ellipse

Circular geometry

create_rectangle

Rectangular polylines

create_sphere, create_box, create_cylinder, create_cone, create_torus

Solid primitives

create_extrusion, create_pipe

Extrude and pipe along curves

create_surface_from_points, create_mesh

NURBS surfaces and meshes

create_text

Text dots

create_loft

Loft surfaces through cross-sections

create_sweep1, create_sweep2

Single and two-rail sweeps

create_revolve

Revolve profiles around an axis

create_planar_surface, create_patch

Planar and patch surfaces

Transforms (8 tools)

move, rotate, scale, scale_non_uniform, mirror, copy, array_linear, array_polar

Boolean Operations (3 tools)

boolean_union, boolean_difference, boolean_intersection

Modification (18 tools)

Tool

Description

delete, set_color, set_material, set_name, set_layer

Basic modifications

group, ungroup

Grouping

join, explode

Join and explode geometry

trim, split

Trim and split curves

offset_curve, offset_surface

Offset geometry

fillet_edge, chamfer_edge, fillet_curves

Edge treatments

cap_planar_holes

Cap open breps

extend_curve, rebuild_curve

Curve editing

project_to_surface

Project curves onto surfaces

duplicate_edge, duplicate_border

Extract edges/borders

Blocks & Instances (4 tools)

create_block, insert_block, list_blocks, explode_block

User Data (2 tools)

set_user_text, get_user_text: store metadata, BIM data, costs, etc.

Layers (6 tools)

list_layers, create_layer, delete_layer, set_layer_color, set_layer_visibility, set_current_layer

Materials (3 tools)

list_materials, create_material, assign_material

Analysis (10 tools)

Tool

Description

get_bounding_box, get_area, get_volume, get_length

Measurements

distance, closest_point

Spatial queries

intersect

Find intersections between objects

get_curvature

Curvature analysis

is_point_on_surface, is_point_in_solid

Point containment tests

Diagnostics (4 tools)

Tool

Description

check_objects

Check validity, find bad geometry

get_naked_edges

Find gaps in surfaces

check_mesh

Mesh quality analysis

repair_mesh

Fix mesh issues automatically

View (5 tools)

zoom_extents, set_view, capture_view (with base64 option), list_views, set_display_mode

Grasshopper (3 tools)

gh_run_script, gh_set_slider, gh_get_outputs

Code Execution (2 tools)

run_python, run_command: full access to rhinoscriptsyntax and RhinoCommon

Undo/Redo (2 tools)

undo, redo

Scene (4 tools)

scene_info, get_objects, get_object (detailed with edge info), select_objects

Import/Export (2 tools)

export (.3dm, .obj, .stl, .step, .iges, .fbx), import_file

Bold = new in v2.0

Prerequisites

  • Rhino 7 or 8 (Windows or Mac)

  • Python 3.10+

  • uv package manager (install)

Installation

1. Clone and install

git clone https://github.com/kbangaru-cyber/rhino-mcp.git
cd Rhino_MCP
uv sync

2. Start the Rhino listener

In Rhino:

  1. Go to Tools > PythonScript > Run

  2. Select rhino/listener.py

  3. You should see:

============================================================
  RhinoMCP Listener v2.0.0
  Listening on 127.0.0.1:9876
  Registered handlers: 90
  Ready for MCP connection (Claude)
============================================================

3. Configure Claude Desktop

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "rhino": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/Rhino_MCP", "run", "rhino-mcp"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1",
        "RHINO_MCP_PORT": "9876",
        "RHINO_MCP_TIMEOUT": "30"
      }
    }
  }
}

Usage Examples

Create a simple building form

"Create a 10x8x4 meter box for the building volume, then add a cylinder of radius 2 and height 6 at the center for a tower. Union them together and fillet all edges with radius 0.3."

Diagnose model problems

"Check all objects in the scene for problems. Find any naked edges and tell me what needs fixing."

Parametric design

"Create a vase shape by making a profile curve and revolving it. Then create a polar array of decorative cylinders around it."

Built-in Prompts

RhinoMCP includes guided workflow prompts:

  • model-from-description: structured workflow for creating 3D models from text descriptions

  • diagnose-model: systematic approach to finding and fixing model problems

  • parametric-design: guide for Grasshopper/parametric workflows

Resources

The server exposes live data as MCP resources:

URI

Description

rhino://scene/info

Current scene overview

rhino://layers

Layer tree

rhino://materials

Material list

rhino://blocks

Block definitions

Configuration

Environment Variable

Default

Description

RHINO_MCP_HOST

127.0.0.1

Rhino listener host

RHINO_MCP_PORT

9876

Rhino listener port

RHINO_MCP_TIMEOUT

30

Command timeout (seconds)

Development

# Install dev dependencies
uv sync --extra dev

# Run tests (no Rhino needed)
uv run pytest -v

# Lint
uv run ruff check .

# Type check
uv run mypy rhino_mcp

Integration testing

With Rhino running and the listener active:

uv run pytest -v -m integration

Protocol

Commands are JSON objects sent over TCP (newline-delimited):

{"id": "abc123", "action": "create_sphere", "params": {"center": [0,0,0], "radius": 5}}

Responses:

{"id": "abc123", "ok": true, "result": {"guid": "d3e4f5..."}}

Thread Safety

The Rhino listener uses Rhino.RhinoApp.InvokeOnUiThread() on Rhino 8+ to ensure all geometry operations run on the UI thread. On Rhino 7, operations execute directly (which is safe for single-client connections).

License

MIT. See LICENSE.

Author

Karthick Raja B G, portfolio · GitHub

Related work: SPIDER, a Grasshopper plugin for computational geometry and spatial analysis.

Available Tools

105 tools
rhino_array_linearB

Create a linear array of objects along a direction with even spacing.

Inputs: params (required). Returns: result

rhino_array_polarB

Create a polar (circular) array of objects around a center point.

Inputs: params (required). Returns: result

rhino_assign_materialC
Idempotent

Assign an existing material to objects.

Inputs: params (required). Returns: result

rhino_boolean_differenceB
Destructive

Subtract solid B from solid A.

Inputs: params (required). Returns: result

rhino_boolean_intersectionC
Destructive

Keep only the intersecting volume of two solids.

Inputs: params (required). Returns: result

rhino_boolean_unionA
Destructive

Boolean union of two solids (merge into one).

Inputs: params (required). Returns: result

rhino_cap_planar_holesA
Destructive

Cap all planar openings on an open brep to make it solid.

Inputs: params (required). Returns: result

rhino_capture_viewA
Read-onlyIdempotent

Capture the active viewport as a PNG image. Set include_base64=true to get the image data directly in the response.

Inputs: params (required). Returns: result

rhino_chamfer_edgeB
Destructive

Apply a chamfer (beveled edge) to specified edges of a solid. Use get_object first to see available edge indices.

Inputs: params (required). Returns: result

rhino_check_meshA
Read-onlyIdempotent

Check mesh quality: closed, normals, degenerate faces, naked edges.

Inputs: params (required). Returns: result

rhino_check_objectsA
Read-onlyIdempotent

Check objects for validity, bad geometry, naked edges, and common problems. Provide specific GUIDs or leave empty to check the entire scene.

Inputs: params (required). Returns: result

rhino_closest_pointA
Read-onlyIdempotent

Find the closest point on an object to a test point.

Inputs: params (required). Returns: result

rhino_copyB

Duplicate objects with an optional translation offset.

Inputs: params (required). Returns: result

rhino_create_arcB

Create an arc from center, radius, and angle range.

Inputs: params (required). Returns: result

rhino_create_blockC

Create a block definition from existing objects. Blocks are reusable geometry instances that save memory and allow batch updates.

Inputs: params (required). Returns: result

rhino_create_boxB

Create a box/cuboid with origin, width, depth, and height.

Inputs: params (required). Returns: result

rhino_create_circleC

Create a circle with given center, radius, and optional plane normal.

Inputs: params (required). Returns: result

rhino_create_coneC

Create a cone with base center, radius, and height.

Inputs: params (required). Returns: result

rhino_create_curveC

Create an interpolated NURBS curve through control points.

Inputs: params (required). Returns: result

rhino_create_cylinderB

Create a cylinder with base center, radius, and height.

Inputs: params (required). Returns: result

rhino_create_ellipseC

Create an ellipse with separate X and Y radii.

Inputs: params (required). Returns: result

rhino_create_extrusionB

Extrude an existing curve along a direction. Caps closed curves.

Inputs: params (required). Returns: result

rhino_create_layerC

Create a new layer. Use :: for nesting (e.g., 'Walls::Interior').

Inputs: params (required). Returns: result

rhino_create_lineC

Create a line from start to end point.

Inputs: params (required). Returns: result

rhino_create_loftA

Loft a surface through multiple cross-section curves. Great for creating smooth transitions between different profile shapes.

Inputs: params (required). Returns: result

rhino_create_materialB

Create a new render material with color, transparency, and reflectivity.

Inputs: params (required). Returns: result

rhino_create_meshA

Create a mesh from vertices and face indices (triangles or quads).

Inputs: params (required). Returns: result

rhino_create_patchA

Create a patch surface from boundary curves and/or interior points.

Inputs: params (required). Returns: result

rhino_create_pipeC

Create a pipe (tube) along an existing rail curve.

Inputs: params (required). Returns: result

rhino_create_planar_surfaceA

Create a planar surface from one or more closed planar curves.

Inputs: params (required). Returns: result

rhino_create_pointD

Create a point object in Rhino.

Inputs: params (required). Returns: result

rhino_create_pointsC

Create multiple point objects at once.

Inputs: params (required). Returns: result

rhino_create_polylineB

Create a polyline through ordered vertices. Optionally close it into a polygon.

Inputs: params (required). Returns: result

rhino_create_rectangleB

Create a rectangle from origin, width, and height.

Inputs: params (required). Returns: result

rhino_create_revolveA

Revolve a profile curve around an axis to create a surface of revolution. Use for creating vases, goblets, turned parts, etc.

Inputs: params (required). Returns: result

rhino_create_sphereA

Create a solid sphere with given center and radius.

Inputs: params (required). Returns: result

rhino_create_surface_from_pointsC

Create a NURBS surface from a grid of control points.

Inputs: params (required). Returns: result

rhino_create_sweep1B

Sweep one or more cross-section curves along a single rail curve. Useful for creating moldings, pipes with varying cross-sections, etc.

Inputs: params (required). Returns: result

rhino_create_sweep2A

Sweep cross-section curves along two rail curves. Gives more control over the shape of the resulting surface than single-rail sweep.

Inputs: params (required). Returns: result

rhino_create_textC

Create a text dot (always-facing label) at a point.

Inputs: params (required). Returns: result

rhino_create_torusC

Create a torus (donut shape) with major and minor radii.

Inputs: params (required). Returns: result

rhino_deleteB
Destructive

Permanently delete objects by GUID.

Inputs: params (required). Returns: result

rhino_delete_layerA
Destructive

Delete a layer and its objects.

Inputs: params (required). Returns: result

rhino_distanceB
Read-onlyIdempotent

Calculate the distance between two objects.

Inputs: params (required). Returns: result

rhino_duplicate_borderB

Duplicate the border/naked edge curves of a surface, brep, or mesh.

Inputs: params (required). Returns: result

rhino_duplicate_edgeC

Duplicate the edges of a brep as individual curves.

Inputs: params (required). Returns: result

rhino_explodeB
Destructive

Explode compound objects into individual components.

Inputs: params (required). Returns: result

rhino_explode_blockA
Destructive

Explode a block instance into its constituent objects.

Inputs: params (required). Returns: result

rhino_exportB
Read-onlyIdempotent

Export objects or the entire scene to a file (.3dm, .obj, .stl, .step, .iges, .fbx).

Inputs: params (required). Returns: result

rhino_extend_curveB
Destructive

Extend a curve by a given length from start, end, or both ends.

Inputs: params (required). Returns: result

rhino_fillet_curvesC

Create a fillet arc between two curves at their intersection.

Inputs: params (required). Returns: result

rhino_fillet_edgeA
Destructive

Apply a fillet (rounded edge) to specified edges of a solid. Use get_object first to see available edge indices.

Inputs: params (required). Returns: result

rhino_get_areaB
Read-onlyIdempotent

Calculate the surface area of a surface, brep, or mesh.

Inputs: params (required). Returns: result

rhino_get_bounding_boxA
Read-onlyIdempotent

Get the axis-aligned bounding box of an object: min/max points, dimensions, center.

Inputs: params (required). Returns: result

rhino_get_curvatureB
Read-onlyIdempotent

Get curvature at a point on a curve or surface. Returns curvature, radius of curvature, tangent, and (for surfaces) gaussian/mean curvature.

Inputs: params (required). Returns: result

rhino_get_lengthB
Read-onlyIdempotent

Calculate the length of a curve.

Inputs: params (required). Returns: result

rhino_get_naked_edgesA

Find and duplicate the naked (unjoined) edges of a brep. These indicate gaps in the surface that prevent it from being a closed solid.

Inputs: params (required). Returns: result

rhino_get_objectA
Read-onlyIdempotent

Get detailed information about a specific object by GUID, including geometry type, dimensions, area, volume, edge info, material, and user data.

Inputs: params (required). Returns: result

rhino_get_objectsA
Read-onlyIdempotent

List objects in the scene with optional filters by type, layer, or name. Returns guid, name, type, layer, color, and bounding box for each.

Inputs: params (required). Returns: result

rhino_get_user_textA
Read-onlyIdempotent

Get user text from an object. Returns a specific key or all key/value pairs.

Inputs: params (required). Returns: result

rhino_get_volumeC
Read-onlyIdempotent

Calculate the volume of a closed solid.

Inputs: params (required). Returns: result

rhino_gh_get_outputsA
Read-onlyIdempotent

Read current output values from the active Grasshopper definition.

Inputs: no named parameters. Returns: result

rhino_gh_run_scriptB

Execute a GHPython script inside Grasshopper. Has access to all Grasshopper and RhinoCommon APIs.

Inputs: params (required). Returns: result

rhino_gh_set_sliderA
Idempotent

Set the value of a Grasshopper slider to drive parametric updates.

Inputs: params (required). Returns: result

rhino_groupB

Group objects together with an optional name.

Inputs: params (required). Returns: result

rhino_import_fileB

Import geometry from a file into the current document.

Inputs: params (required). Returns: result

rhino_insert_blockB

Insert a block instance at a point with optional scale and rotation.

Inputs: params (required). Returns: result

rhino_intersectB
Read-onlyIdempotent

Find intersection between two geometric objects. Creates intersection curves if surfaces/breps intersect.

Inputs: params (required). Returns: result

rhino_is_point_in_solidA
Read-onlyIdempotent

Check if a point is inside a closed solid.

Inputs: params (required). Returns: result

rhino_is_point_on_surfaceA
Read-onlyIdempotent

Check if a point lies on a surface within tolerance.

Inputs: params (required). Returns: result

rhino_joinB
Destructive

Join adjacent curves or surfaces into a single object.

Inputs: params (required). Returns: result

rhino_list_blocksA
Read-onlyIdempotent

List all block definitions in the document.

Inputs: no named parameters. Returns: result

rhino_list_layersA
Read-onlyIdempotent

List all layers with colors, visibility, lock state, and object counts.

Inputs: no named parameters. Returns: result

rhino_list_materialsA
Read-onlyIdempotent

List all render materials in the document.

Inputs: no named parameters. Returns: result

rhino_list_viewsA
Read-onlyIdempotent

List all viewports and named views with their display modes.

Inputs: no named parameters. Returns: result

rhino_mirrorC

Mirror objects across a plane, creating copies.

Inputs: params (required). Returns: result

rhino_moveB

Move objects by a translation vector.

Inputs: params (required). Returns: result

rhino_offset_curveC

Create an offset copy of a curve at a given distance.

Inputs: params (required). Returns: result

rhino_offset_surfaceB

Offset a surface or brep by a distance. Optionally create a solid.

Inputs: params (required). Returns: result

rhino_project_to_surfaceC

Project curves onto a brep/surface along a direction.

Inputs: params (required). Returns: result

rhino_rebuild_curveA
Destructive

Rebuild a curve with a new point count and degree for a smoother result.

Inputs: params (required). Returns: result

rhino_redoB

Redo the last undone operation.

Inputs: no named parameters. Returns: result

rhino_repair_meshA
Destructive

Attempt to repair common mesh issues: degenerate faces, duplicate vertices, unified normals, and optionally fill holes.

Inputs: params (required). Returns: result

rhino_rotateB

Rotate objects around an axis through a center point.

Inputs: params (required). Returns: result

rhino_run_commandC

Execute a Rhino command string as if typed in the command line.

Inputs: params (required). Returns: result

rhino_run_pythonA

Execute arbitrary Python code inside Rhino. Has access to rhinoscriptsyntax (rs), RhinoCommon (Rhino.*), and scriptcontext (sc). Use this for advanced operations not covered by other tools.

Inputs: params (required). Returns: result

rhino_scaleB

Uniformly scale objects from a center point.

Inputs: params (required). Returns: result

rhino_scale_non_uniformD

Scale objects with separate X, Y, Z factors.

Inputs: params (required). Returns: result

rhino_scene_infoA
Read-onlyIdempotent

Get an overview of the current Rhino document: filename, unit system, tolerances, object count by type, layers, and active view.

Inputs: no named parameters. Returns: result

rhino_select_objectsB
Idempotent

Select objects in the Rhino viewport by their GUIDs.

Inputs: params (required). Returns: result

rhino_set_colorB
Idempotent

Set the display color on objects.

Inputs: params (required). Returns: result

rhino_set_current_layerC
Idempotent

Set the active/current layer.

Inputs: params (required). Returns: result

rhino_set_display_modeA
Idempotent

Set the display mode of the active viewport (Wireframe, Shaded, Rendered, etc.).

Inputs: params (required). Returns: result

rhino_set_layerC
Idempotent

Move objects to a specified layer.

Inputs: params (required). Returns: result

rhino_set_layer_colorC
Idempotent

Change the color of a layer.

Inputs: params (required). Returns: result

rhino_set_layer_visibilityB
Idempotent

Show or hide a layer.

Inputs: params (required). Returns: result

rhino_set_materialB
Idempotent

Assign a named material to objects.

Inputs: params (required). Returns: result

rhino_set_nameA
Idempotent

Set or change the name of a Rhino object.

Inputs: params (required). Returns: result

rhino_set_user_textB
Idempotent

Set a user text key/value pair on objects. Useful for storing metadata, BIM data, cost information, etc.

Inputs: params (required). Returns: result

rhino_set_viewB
Idempotent

Switch the viewport to a named view (Top, Front, Right, Perspective, etc.).

Inputs: params (required). Returns: result

rhino_splitB
Destructive

Split a curve at its intersection with a cutting object.

Inputs: params (required). Returns: result

rhino_trimB
Destructive

Trim a curve at its intersection with a cutting object.

Inputs: params (required). Returns: result

rhino_undoA

Undo the last operation in Rhino.

Inputs: no named parameters. Returns: result

rhino_ungroupA
Idempotent

Ungroup a named group, releasing its members.

Inputs: params (required). Returns: result

rhino_zoom_extentsA
Idempotent

Zoom the active viewport to show the entire scene.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 105 tools

    Disambiguation2/5

    Most geometry creation/editing tools are distinguishable by their object type and operation, but the set contains direct duplicates (set_material/assign_material, duplicate_border/get_naked_edges) and overlapping checks (check_objects/check_mesh). With 105 tools, an agent must navigate many near-synonyms and the line between trim/split and copy/array is not always obvious.

    Naming Consistency4/5

    Tools consistently use the rhino_ prefix with snake_case verb_noun operations, making groups like create_* and get_* easy to scan. Minor inconsistencies exist (scene_info is noun-only, distance/intersect have no target, set_material vs assign_material) but they do not undermine the overall pattern.

    Tool Count1/5

    At 105 tools, this is an extreme mismatch for an MCP tool surface, far beyond the 25+ threshold where selection overhead becomes severe. Many narrow variants (e.g., point vs points, multiple sweep/loft surface creators) could be consolidated without losing capability.

    Completeness4/5

    The server covers the full Rhino modeling lifecycle: primitive creation, editing, transformations, booleans, analysis, layers, materials, blocks, Grasshopper, and file I/O. Minor gaps like layer rename/lock or block definition removal exist, but the universal run_python and run_command escape hatches prevent dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Autodesk Revit to query project data, manage elements, and execute generated code via the Model Context Protocol. It provides full compatibility with GitHub Copilot and Claude to automate BIM modeling workflows.
      13
      MIT
    • 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