GH_mcp_server logo

GH_mcp_server

by veoery

GH_mcp_server allows designers to interact with Rhino and Grasshopper directly via LLMs. It enables analysis of .3dm files, 3D modeling, and automatic generation of GHPython in Grasshopper based on user guidance.

View on GitHub

Last updated: N/A

What is GH_mcp_server?

GH_mcp_server is a tool that bridges the gap between Large Language Models (LLMs) and 3D design software like Rhino and Grasshopper. It allows users to use natural language prompts to analyze 3D models, create new designs, and generate Grasshopper Python scripts automatically.

How to use GH_mcp_server?

  1. Clone the repository and set up the environment using uv. 2. Configure Claude Desktop to recognize the GH_mcp_server. 3. Start Rhino and run the CodeListener command. 4. Use Claude Desktop to send prompts to interact with Rhino and Grasshopper, referencing examples for guidance.

Key features of GH_mcp_server

  • LLM-based interaction with Rhino and Grasshopper

  • Analysis of .3dm files

  • Automated 3D modeling

  • Automatic GHPython script generation

  • Integration with Claude Desktop

Use cases of GH_mcp_server

  • Generating complex geometries in Grasshopper using natural language prompts

  • Automating repetitive modeling tasks

  • Analyzing existing 3D models using LLMs

  • Creating parametric designs driven by AI

  • Rapid prototyping and exploration of design ideas

FAQ from GH_mcp_server

What software versions are supported?

Rhino 7 or 8 is required.

What is uv and why is it needed?

uv is a fast, modern Python package installer and resolver. It is recommended for setting up the project environment.

How do I configure Claude Desktop?

Navigate to Settings->Developer in Claude Desktop, edit the config file, and add the GH_mcp_server configuration with the correct paths.

What is the CodeListener command in Rhino?

The CodeListener command starts a listener in Rhino that allows VS Code (and by extension, the GH_mcp_server via Claude Desktop) to interact with Rhino.

Where can I find examples of how to use the server?

Check the examples directory in the repository for sample Grasshopper files and prompts.