RhinoMCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RhinoMCP Create a loft surface through the selected curves."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Single or batch point creation |
| Lines and polylines |
| Interpolated NURBS curves |
| Circular geometry |
| Rectangular polylines |
| Solid primitives |
| Extrude and pipe along curves |
| NURBS surfaces and meshes |
| Text dots |
| Loft surfaces through cross-sections |
| Single and two-rail sweeps |
| Revolve profiles around an axis |
| 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 |
| Basic modifications |
| Grouping |
| Join and explode geometry |
| Trim and split curves |
| Offset geometry |
| Edge treatments |
| Cap open breps |
| Curve editing |
| Project curves onto surfaces |
| 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 |
| Measurements |
| Spatial queries |
| Find intersections between objects |
| Curvature analysis |
| Point containment tests |
Diagnostics (4 tools)
Tool | Description |
| Check validity, find bad geometry |
| Find gaps in surfaces |
| Mesh quality analysis |
| 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 sync2. Start the Rhino listener
In Rhino:
Go to Tools > PythonScript > Run
Select
rhino/listener.pyYou 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 descriptionsdiagnose-model: systematic approach to finding and fixing model problemsparametric-design: guide for Grasshopper/parametric workflows
Resources
The server exposes live data as MCP resources:
URI | Description |
| Current scene overview |
| Layer tree |
| Material list |
| Block definitions |
Configuration
Environment Variable | Default | Description |
|
| Rhino listener host |
|
| Rhino listener port |
|
| 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_mcpIntegration testing
With Rhino running and the listener active:
uv run pytest -v -m integrationProtocol
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 toolsrhino_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_materialCIdempotent
Assign an existing material to objects.
Inputs: params (required). Returns: result
rhino_boolean_differenceBDestructive
Subtract solid B from solid A.
Inputs: params (required). Returns: result
rhino_boolean_intersectionCDestructive
Keep only the intersecting volume of two solids.
Inputs: params (required). Returns: result
rhino_boolean_unionADestructive
Boolean union of two solids (merge into one).
Inputs: params (required). Returns: result
rhino_cap_planar_holesADestructive
Cap all planar openings on an open brep to make it solid.
Inputs: params (required). Returns: result
rhino_capture_viewARead-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_edgeBDestructive
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_meshARead-onlyIdempotent
Check mesh quality: closed, normals, degenerate faces, naked edges.
Inputs: params (required). Returns: result
rhino_check_objectsARead-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_pointARead-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_deleteBDestructive
Permanently delete objects by GUID.
Inputs: params (required). Returns: result
rhino_delete_layerADestructive
Delete a layer and its objects.
Inputs: params (required). Returns: result
rhino_distanceBRead-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_explodeBDestructive
Explode compound objects into individual components.
Inputs: params (required). Returns: result
rhino_explode_blockADestructive
Explode a block instance into its constituent objects.
Inputs: params (required). Returns: result
rhino_exportBRead-onlyIdempotent
Export objects or the entire scene to a file (.3dm, .obj, .stl, .step, .iges, .fbx).
Inputs: params (required). Returns: result
rhino_extend_curveBDestructive
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_edgeADestructive
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_areaBRead-onlyIdempotent
Calculate the surface area of a surface, brep, or mesh.
Inputs: params (required). Returns: result
rhino_get_bounding_boxARead-onlyIdempotent
Get the axis-aligned bounding box of an object: min/max points, dimensions, center.
Inputs: params (required). Returns: result
rhino_get_curvatureBRead-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_lengthBRead-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_objectARead-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_objectsARead-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_textARead-onlyIdempotent
Get user text from an object. Returns a specific key or all key/value pairs.
Inputs: params (required). Returns: result
rhino_get_volumeCRead-onlyIdempotent
Calculate the volume of a closed solid.
Inputs: params (required). Returns: result
rhino_gh_get_outputsARead-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_sliderAIdempotent
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_intersectBRead-onlyIdempotent
Find intersection between two geometric objects. Creates intersection curves if surfaces/breps intersect.
Inputs: params (required). Returns: result
rhino_is_point_in_solidARead-onlyIdempotent
Check if a point is inside a closed solid.
Inputs: params (required). Returns: result
rhino_is_point_on_surfaceARead-onlyIdempotent
Check if a point lies on a surface within tolerance.
Inputs: params (required). Returns: result
rhino_joinBDestructive
Join adjacent curves or surfaces into a single object.
Inputs: params (required). Returns: result
rhino_list_blocksARead-onlyIdempotent
List all block definitions in the document.
Inputs: no named parameters. Returns: result
rhino_list_layersARead-onlyIdempotent
List all layers with colors, visibility, lock state, and object counts.
Inputs: no named parameters. Returns: result
rhino_list_materialsARead-onlyIdempotent
List all render materials in the document.
Inputs: no named parameters. Returns: result
rhino_list_viewsARead-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_curveADestructive
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_meshADestructive
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_infoARead-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_objectsBIdempotent
Select objects in the Rhino viewport by their GUIDs.
Inputs: params (required). Returns: result
rhino_set_colorBIdempotent
Set the display color on objects.
Inputs: params (required). Returns: result
rhino_set_current_layerCIdempotent
Set the active/current layer.
Inputs: params (required). Returns: result
rhino_set_display_modeAIdempotent
Set the display mode of the active viewport (Wireframe, Shaded, Rendered, etc.).
Inputs: params (required). Returns: result
rhino_set_layerCIdempotent
Move objects to a specified layer.
Inputs: params (required). Returns: result
rhino_set_layer_colorCIdempotent
Change the color of a layer.
Inputs: params (required). Returns: result
rhino_set_layer_visibilityBIdempotent
Show or hide a layer.
Inputs: params (required). Returns: result
rhino_set_materialBIdempotent
Assign a named material to objects.
Inputs: params (required). Returns: result
rhino_set_nameAIdempotent
Set or change the name of a Rhino object.
Inputs: params (required). Returns: result
rhino_set_user_textBIdempotent
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_viewBIdempotent
Switch the viewport to a named view (Top, Front, Right, Perspective, etc.).
Inputs: params (required). Returns: result
rhino_splitBDestructive
Split a curve at its intersection with a cutting object.
Inputs: params (required). Returns: result
rhino_trimBDestructive
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_ungroupAIdempotent
Ungroup a named group, releasing its members.
Inputs: params (required). Returns: result
rhino_zoom_extentsAIdempotent
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
Scored across 105 tools
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.
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.
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.
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
Related MCP Connectors
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
AI for Revit: 450+ tools, 1 undo step. Windows, Revit 2024–2027 (2021–2023 included). Free account.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects Rhino3D to Claude AI via the Model Context Protocol, enabling AI-assisted 3D modeling and design workflows through direct control of Rhino's functionality.13-
- AlicenseAqualityDmaintenanceEnables 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.13MIT
- AlicenseNot gradedqualityDmaintenanceConnects 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.32MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered 3D modeling in Rhino 8 through 135+ tools for geometry, transformations, booleans, layers, materials, and more, using natural language.7MIT