Skip to main content
Glama
GH_mcp_server
by veoery

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!

Alt text

Requirements

Related MCP server: cadkit

Installation

1. Clone the repository

git clone git@github.com:veoery/GH_mcp_server.git
cd GH_mcp_server

2. 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

  1. In the Claude Desktop, Navigate to Settings->Developer. You will see Edit Config.

  2. Click the Edit Config and open the file claude_desktop_config.json

  3. Place 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"
          ]
        }
      }
    }
  4. 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

  1. Start Rhino

  2. Type command CodeListener. You should see VS Code Listener Started....

  3. Open the Claude Desktop and type the prompts to interact with GH_mcp_server tools. Please also check the file examples\zaha01.gh as 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 tools
add_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

    B3.1/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    With 8 tools, the server covers core Grasshopper and Rhino operations without being excessive. Each tool serves a clear function within the expected scope.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      33
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A local, offline MCP server that enables AI agents to collaborate with SketchUp for controlled modeling, editing, and review tasks via 41 MCP tools.
      12
      Apache 2.0