Grasshopper MCP Bridge

Features

• Connects Grasshopper and Claude Desktop through the MCP protocol

• Provides intuitive tool functions for creating and connecting Grasshopper components

• Supports high-level intent recognition, automatically creating complex component patterns from simple descriptions

• Includes a component knowledge base that understands parameters and connection rules for common components

• Provides component guidance resources to help Claude Desktop correctly connect components

System Architecture

1. Grasshopper MCP Component (GH_MCP.gha): A plugin installed in Grasshopper that provides a TCP server to receive commands

2. Python MCP Bridge Server: A bridge server that connects Claude Desktop and the Grasshopper MCP component

3. Component Knowledge Base: JSON files containing component information, patterns, and intents

Installation Instructions

Prerequisites

• Rhino 7 or higher

• Grasshopper

• Python 3.8 or higher

• Claude Desktop

Installation Steps

1. Install the Grasshopper MCP ComponentMethod 1: Download the pre-compiled GH_MCP.gha file (Recommended)Download the GH_MCP.gha file directly from the GitHub repository and copy it to the Grasshopper components folder:Method 2: Build from sourceIf you prefer to build from source, clone the repository and build the C# project using Visual Studio.

2. Install the Python MCP Bridge ServerMethod 1: Install from PyPI (Recommended)The simplest method is to install directly from PyPI using pip:Method 2: Install from GitHubYou can also install the latest version from GitHub:Method 3: Install from Source CodeIf you need to modify the code or develop new features, you can clone the repository and install:Install a Specific VersionIf you need to install a specific version, you can use:Or install from a specific GitHub tag:

Usage

1. Start Rhino and GrasshopperLaunch Rhino and open Grasshopper.

2. Add the GH_MCP Component to Your CanvasFind the GH_MCP component in the Grasshopper component panel and add it to your canvas.

3. Start the Python MCP Bridge ServerOpen a terminal and run:

4. Connect Claude Desktop to the MCP BridgeMethod 1: Manual ConnectionIn Claude Desktop, connect to the MCP Bridge server using the following settings:Method 2: Configure Claude Desktop to Auto-Start the BridgeYou can configure Claude Desktop to automatically start the MCP Bridge server by modifying its configuration:This configuration tells Claude Desktop to use the command python -m grasshopper_mcp.bridge to start the MCP server.

5. Start Using Grasshopper with Claude DesktopYou can now use Claude Desktop to control Grasshopper through natural language commands.

Example Commands

• "Create a circle with radius 5 at point (0,0,0)"

• "Connect the circle to a extrude component with a height of 10"

• "Create a grid of points with 5 rows and 5 columns"

• "Apply a random rotation to all selected objects"

Troubleshooting

1. GH_MCP Component Not Loading

2. Bridge Server Won't Start

3. Claude Desktop Can't Connect

4. Commands Not Executing

Development

Project Structure

Contributing

License

Acknowledgments

• Thanks to the Rhino and Grasshopper community for their excellent tools

• Thanks to Anthropic for Claude Desktop and the MCP protocol

Contact

Grasshopper MCP Bridge

Features

• Connects Grasshopper and Claude Desktop through the MCP protocol

• Provides intuitive tool functions for creating and connecting Grasshopper components

• Supports high-level intent recognition, automatically creating complex component patterns from simple descriptions

• Includes a component knowledge base that understands parameters and connection rules for common components

• Provides component guidance resources to help Claude Desktop correctly connect components

System Architecture

1. Grasshopper MCP Component (GH_MCP.gha): A plugin installed in Grasshopper that provides a TCP server to receive commands

2. Python MCP Bridge Server: A bridge server that connects Claude Desktop and the Grasshopper MCP component

3. Component Knowledge Base: JSON files containing component information, patterns, and intents

Installation Instructions

Prerequisites

• Rhino 7 or higher

• Grasshopper

• Python 3.8 or higher

• Claude Desktop

Installation Steps

1. Install the Grasshopper MCP ComponentMethod 1: Download the pre-compiled GH_MCP.gha file (Recommended)Download the GH_MCP.gha file directly from the GitHub repository and copy it to the Grasshopper components folder:Method 2: Build from sourceIf you prefer to build from source, clone the repository and build the C# project using Visual Studio.

2. Install the Python MCP Bridge ServerMethod 1: Install from PyPI (Recommended)The simplest method is to install directly from PyPI using pip:Method 2: Install from GitHubYou can also install the latest version from GitHub:Method 3: Install from Source CodeIf you need to modify the code or develop new features, you can clone the repository and install:Install a Specific VersionIf you need to install a specific version, you can use:Or install from a specific GitHub tag:

Usage

1. Start Rhino and GrasshopperLaunch Rhino and open Grasshopper.

2. Add the GH_MCP Component to Your CanvasFind the GH_MCP component in the Grasshopper component panel and add it to your canvas.

3. Start the Python MCP Bridge ServerOpen a terminal and run:

4. Connect Claude Desktop to the MCP BridgeMethod 1: Manual ConnectionIn Claude Desktop, connect to the MCP Bridge server using the following settings:Method 2: Configure Claude Desktop to Auto-Start the BridgeYou can configure Claude Desktop to automatically start the MCP Bridge server by modifying its configuration:This configuration tells Claude Desktop to use the command python -m grasshopper_mcp.bridge to start the MCP server.

5. Start Using Grasshopper with Claude DesktopYou can now use Claude Desktop to control Grasshopper through natural language commands.

Example Commands

• "Create a circle with radius 5 at point (0,0,0)"

• "Connect the circle to a extrude component with a height of 10"

• "Create a grid of points with 5 rows and 5 columns"

• "Apply a random rotation to all selected objects"

Troubleshooting

1. GH_MCP Component Not Loading

2. Bridge Server Won't Start

3. Claude Desktop Can't Connect

4. Commands Not Executing

Development

Project Structure

Contributing

License

Acknowledgments

• Thanks to the Rhino and Grasshopper community for their excellent tools

• Thanks to Anthropic for Claude Desktop and the MCP protocol

Contact