GH_mcp_server
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., "@GH_mcp_server Analyze the 3dm file 'model.3dm'"
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.
GH_mcp_server
GH_mcp_server provides an approach that allows designer to interact with Rhino and Grasshopper directly via LLMs, including to analyse .3dm file, do 3D modeling and generate GHPython automatically in Grasshopper based on user’s guidance.
This project is still under construction — and we’d love your help!
Feel free to open an issue if you encounter bugs or have ideas.
Pull requests are always welcome.
If you're interested in collaborating long-term, feel free to reach out to yizhuod@andrew.cmu.edu — we’d love to have you on the team!

Requirements
Rhino 7 or 8
Install
RhinoPython: https://github.com/jingcheng-chen/RhinoPythonForVscode/tree/master?tab=readme-ov-fileuv# For MacOS and Linux curl -LsSf https://astral.sh/uv/install.sh | sh# For Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Claude Desktop
Related MCP server: cadkit
Installation
1. Clone the repository
git clone git@github.com:veoery/GH_mcp_server.git
cd GH_mcp_server2. Set up the environment
We recommend using uv:
macOS/Linux
uv venv
source .venv/bin/activate
uv pip install -e .Windows
uv venv
.venv\Scripts\activate
uv pip install -e .Make sure the virtual environment is activated before running or developing the project.
3. Configuration
In the Claude Desktop, Navigate to Settings->Developer. You will see
Edit Config.Click the
Edit Configand open the fileclaude_desktop_config.jsonPlace the following code to the json file:
{ "mcpServers": { "grasshopper": { "command": "path_to_GH_mcp_server/.venv/bin/python", "args": [ "path_to_GH_mcp_server/run_server.py" ] } } }Restart the Claude Desktop. If you are able to see a hammer icon, the configuration is successful. Click the hammer icon to check all the attached MCP tools.
Usage
Start Rhino
Type command
CodeListener. You should seeVS Code Listener Started....Open the Claude Desktop and type the prompts to interact with GH_mcp_server tools. Please also check the file
examples\zaha01.ghas a reference for interacting with Grasshopper. Here are some examples:Read the file "D:\test01.3dm" first and analyse the objects in this file.write GHpython to create a tower referring to zaha and write the ghpython code to "D:\zaha01.py"
Available Tools
8 toolsadd_grasshopper_componentC
Add a component from an existing Grasshopper plugin.
Args: component_name: Name of the component component_type: Type/category of the component parameters: Component parameters and settings
Returns: Result of the operation
Inputs: component_name (required), component_type (required), parameters (required).
analyze_rhino_fileC
Analyze a Rhino (.3dm) file.
Args: file_path: Path to the .3dm file
Returns: Analysis of the file contents
Inputs: file_path (required).
connect_grasshopper_componentsC
Connect parameters between Grasshopper components.
Args: source_id: Source component ID source_param: Source parameter name target_id: Target component ID target_param: Target parameter name
Returns: Result of the operation
Inputs: source_id (required), source_param (required), target_id (required), target_param (required).
execute_grasshopper_codeC
Execute given Python code.
Args: code: The given code to execute file_path: Path where the generated code will be saved
Returns: Result of the executing code
Inputs: code (required), file_path (required).
extract_geometryB
Extract geometric data from an existing object.
Args: file_path: Path to the .3dm file object_index: Index of the object to extract data from
Returns: Geometric data in a readable format
Inputs: file_path (required), object_index (required).
list_objectsB
List all objects in a Rhino file.
Args: file_path: Path to the .3dm file
Returns: Information about objects in the file
Inputs: file_path (required).
measure_distanceB
Measure the distance between two objects in a Rhino file.
Args: file_path: Path to the .3dm file object_index1: Index of the first object object_index2: Index of the second object
Returns: Distance measurement information
Inputs: file_path (required), object_index1 (required), object_index2 (required).
run_grasshopper_definitionB
Run a Grasshopper definition.
Args: file_path: Path to the .gh file (or None for current definition) save_output: Whether to save the output output_path: Path to save the output (if save_output is True)
Returns: Result of the operation
Inputs: file_path, save_output, output_path.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct purposes, but 'execute_grasshopper_code' is ambiguous because it executes Python code, not Grasshopper code, potentially causing confusion with other Grasshopper-related tools.
All tool names follow a verb_noun snake_case pattern, which is consistent. However, 'execute_grasshopper_code' is misleading as it executes Python code, not Grasshopper code, slightly breaking the semantic consistency.
With 8 tools, the server covers core Grasshopper and Rhino operations without being excessive. Each tool serves a clear function within the expected scope.
The tool set lacks creation and modification capabilities for Rhino objects and components. Missing tools for creating new geometry, saving files, or deleting objects, which are essential for a complete workflow.
Maintenance
Related MCP Connectors
MCP-Native LLM Orchestration Agent
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
LLM Orchestration MCP Agent
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that connects LLMs with Autodesk Fusion, enabling CAD operations through natural language dialogue.4MIT
- AlicenseBqualityDmaintenanceAn MCP server for parametric part modeling in Onshape, producing fully-defined, variable-driven sketches and features. It enables LLMs to create editable CAD models using semantic selection and geometrically grounded constraints.331MIT
- AlicenseNot gradedqualityBmaintenanceA local MCP server that enables AI agents to create and edit parametric CAD models through natural language, using a validated operation graph that compiles to real geometry.1MIT
- AlicenseNot gradedqualityBmaintenanceA local, offline MCP server that enables AI agents to collaborate with SketchUp for controlled modeling, editing, and review tasks via 41 MCP tools.12Apache 2.0