Grasshopper MCP Bridge
by alfredatnycu
Grasshopper MCP Bridge is a bridging server that connects Grasshopper and Claude Desktop using the Model Context Protocol (MCP) standard. It provides intuitive tool functions for creating and connecting Grasshopper components.
Last updated: N/A
What is Grasshopper MCP Bridge?
Grasshopper MCP Bridge is a server that facilitates communication between Grasshopper, a visual programming language for Rhino, and Claude Desktop, an AI assistant. It uses the Model Context Protocol (MCP) to enable natural language control of Grasshopper through Claude Desktop.
How to use Grasshopper MCP Bridge?
To use the Grasshopper MCP Bridge, first install the Grasshopper MCP component and the Python bridge server. Then, start Rhino and Grasshopper, add the GH_MCP component to your canvas, and start the Python MCP bridge server. Finally, connect Claude Desktop to the MCP bridge, either manually or by configuring Claude Desktop to auto-start the bridge. You can then use natural language commands in Claude Desktop to control Grasshopper.
Key features of Grasshopper MCP Bridge
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
Use cases of Grasshopper MCP Bridge
Automating Grasshopper workflows with natural language commands
Generating complex geometric designs using AI assistance
Creating interactive design tools that respond to user input
Exploring design options through natural language exploration
FAQ from Grasshopper MCP Bridge
GH_MCP Component Not Loading
GH_MCP Component Not Loading
Ensure the .gha file is in the correct location. In Grasshopper, go to File > Preferences > Libraries and click 'Unblock' to unblock new components. Restart Rhino and Grasshopper.
Bridge Server Won't Start
Bridge Server Won't Start
If grasshopper-mcp command doesn't work, use python -m grasshopper_mcp.bridge instead. Ensure all required Python dependencies are installed. Check if port 8080 is already in use by another application.
Claude Desktop Can't Connect
Claude Desktop Can't Connect
Ensure the bridge server is running. Verify you're using the correct connection settings (localhost:8080). Check the console output of the bridge server for any error messages.
Commands Not Executing
Commands Not Executing
Verify the GH_MCP component is on your Grasshopper canvas. Check the bridge server console for error messages. Ensure Claude Desktop is properly connected to the bridge server.
How do I install a specific version of the bridge?
How do I install a specific version of the bridge?
You can use pip install grasshopper-mcp==0.1.0 or install from a specific GitHub tag using pip install git+https://github.com/alfredatnycu/[email protected]