Grasshopper Parametric Design

🚀 Grasshopper MCP Bridge Server

Grasshopper MCP Bridge is a transit server that connects Grasshopper and Claude Desktop, adhering to the Model Context Protocol (MCP) standard. It effectively bridges the gap between these two platforms, enabling seamless interaction and data exchange.

🚀 Quick Start

Prerequisites

• Ensure you have Python installed on your system.
• Install Visual Studio for compiling the Grasshopper components.

Installation Steps

1. Clone the repository

git clone https://github.com/yourusername/grasshopper-mcp.git
cd grasshopper-mcp

2. Install Python dependencies

pip install -r requirements.txt

3. Compile Grasshopper components

// Open the Visual Studio project in the GH_MCP folder and compile it.

4. Start the bridge server

python grasshopper_mcp/bridge.py

Connect to Claude Desktop

1. Open Claude Desktop.
2. Navigate to Edit > Preferences > Network Settings.
3. Enter the address: http://localhost:8080.
4. Save the settings and restart Claude.

✨ Features

• Connects Grasshopper and Claude Desktop via the MCP protocol.
• Offers intuitive tool functions for creating and connecting Grasshopper components.
• Supports advanced intent recognition, capable of automatically generating complex component patterns based on simple descriptions.
• Includes a preset library applicable to all components.
• Comes with detailed documentation.

📦 System Architecture

grasshopper-mcp/
├── grasshopper_mcp/       # Python bridge server
│   ├── __init__.py
│   └── bridge.py          # Main bridge server implementation
├── GH_MCP/                # Grasshopper components (C#)
│   └── ...
├── releases/              # Pre-compiled binaries
│   └── GH_MCP.gha         # Compiled Grasshopper components
├── setup.py               # Python package setup
└── README.md              # This file

💻 Usage Examples

Start the Bridge Server

In the Grasshopper command-line interface, enter the following commands:

import sys
sys.path.append(r"Your path\grasshopper-mcp\grasshopper_mcp")
import bridge
bridge.start()

📚 Documentation

Troubleshooting

Problem 1: Grasshopper components not loaded

• Ensure the .gha file is in the correct location.
• In Grasshopper, go to File > Preferences > Libraries and click "Unblock" to remove restrictions on new components.
• Restart Rhino and Grasshopper.

Problem 2: Bridge server fails to start

• If the command is invalid, use python -m grasshopper_mcp.bridge instead.
• Ensure all Python dependencies are installed.
• Check if port 8080 is occupied by other programs.

Development Information

Project Structure

grasshopper-mcp/
├── grasshopper_mcp/       # Python bridge server
│   ├── __init__.py
│   └── bridge.py          # Main bridge server implementation
├── GH_MCP/                # Grasshopper components (C#)
│   └── ...
├── releases/              # Pre-compiled binaries
│   └── GH_MCP.gha         # Compiled Grasshopper components
├── setup.py               # Python package setup
└── README.md              # This file

How to Contribute

Contributions are welcome! Feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

🙏 Acknowledgments

• Thanks to the Rhino and Grasshopper communities for providing excellent tools.
• Thanks to Anthropic for providing Claude Desktop and the MCP protocol.