Skip to content
Back to search

grasshopper-mcp

Grasshopper MCP Bridge is a bridging server that connects Grasshopper and Claude Desktop using the Model Context Protocol (MCP) standard.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alfredatnycu--grasshopper-mcp/badge.svg)](/listings/alfredatnycu--grasshopper-mcp)

HTML

<a href="/listings/alfredatnycu--grasshopper-mcp"><img src="/api/listings/alfredatnycu--grasshopper-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Rhino 7 or higher - Grasshopper - Python 3.8 or higher - Claude Desktop

Installation Steps

1. **Install the Grasshopper MCP Component**

**Method 1: Download the pre-compiled GH_MCP.gha file (Recommended)**

Download the [GH_MCP.gha](https://github.com/alfredatnycu/grasshopper-mcp/raw/master/releases/GH_MCP.gha) file directly from the GitHub repository and copy it to the Grasshopper components folder:

   %APPDATA%\Grasshopper\Libraries\

**Method 2: Build from source**

If you prefer to build from source, clone the repository and build the C# project using Visual Studio.

2. **Install the Python MCP Bridge Server**

**Method 1: Install from PyPI (Recommended)**

The simplest method is to install directly from PyPI using pip:

   pip install grasshopper-mcp

**Method 2: Install from GitHub**

You can also install the latest version from GitHub:

   pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git

**Method 3: Install from Source Code**

If you need to modify the code or develop new features, you can clone the repository and install:

   git clone https://github.com/alfredatnycu/grasshopper-mcp.git
   cd grasshopper-mcp
   pip install -e .

**Install a Specific Version**

If you need to install a specific version, you can use:

   pip install grasshopper-mcp==0.1.0

Or install from a specific GitHub tag:

   pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git@v0.1.0

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 191 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Grasshopper MCP Bridge
  2. Grasshopper MCP Bridge is a bridging server that connects Grasshopper and Claude Desktop using the Model Context Protocol (MCP) standard.
  3. ## Features
  4. - Connects Grasshopper and Claude Desktop through the MCP protocol
  5. - Provides intuitive tool functions for creating and connecting Grasshopper components
  6. - Supports high-level intent recognition, automatically creating complex component patterns from simple descriptions
  7. - Includes a component knowledge base that understands parameters and connection rules for common components
  8. - Provides component guidance resources to help Claude Desktop correctly connect components
  9. ## System Architecture
  10. The system consists of the following parts:
  11. 1. **Grasshopper MCP Component (GH_MCP.gha)**: A plugin installed in Grasshopper that provides a TCP server to receive commands
  12. 2. **Python MCP Bridge Server**: A bridge server that connects Claude Desktop and the Grasshopper MCP component
  13. 3. **Component Knowledge Base**: JSON files containing component information, patterns, and intents
  14. ## Installation Instructions
  15. ### Prerequisites
  16. - Rhino 7 or higher
  17. - Grasshopper
  18. - Python 3.8 or higher
  19. - Claude Desktop
  20. ### Installation Steps
  21. 1. **Install the Grasshopper MCP Component**
  22. **Method 1: Download the pre-compiled GH_MCP.gha file (Recommended)**
  23. Download the [GH_MCP.gha](https://github.com/alfredatnycu/grasshopper-mcp/raw/master/releases/GH_MCP.gha) file directly from the GitHub repository and copy it to the Grasshopper components folder:
  24. ```
  25. %APPDATA%\Grasshopper\Libraries\
  26. ```
  27. **Method 2: Build from source**
  28. If you prefer to build from source, clone the repository and build the C# project using Visual Studio.
  29. 2. **Install the Python MCP Bridge Server**
  30. **Method 1: Install from PyPI (Recommended)**
  31. The simplest method is to install directly from PyPI using pip:
  32. ```
  33. pip install grasshopper-mcp
  34. ```
  35. **Method 2: Install from GitHub**
  36. You can also install the latest version from GitHub:
  37. ```
  38. pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git
  39. ```
  40. **Method 3: Install from Source Code**
  41. If you need to modify the code or develop new features, you can clone the repository and install:
  42. ```
  43. git clone https://github.com/alfredatnycu/grasshopper-mcp.git
  44. cd grasshopper-mcp
  45. pip install -e .
  46. ```
  47. **Install a Specific Version**
  48. If you need to install a specific version, you can use:
  49. ```
  50. pip install grasshopper-mcp==0.1.0
  51. ```
  52. Or install from a specific GitHub tag:
  53. ```
  54. pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git@v0.1.0
  55. ```
  56. ## Usage
  57. 1. **Start Rhino and Grasshopper**
  58. Launch Rhino and open Grasshopper.
  59. 2. **Add the GH_MCP Component to Your Canvas**
  60. Find the GH_MCP component in the Grasshopper component panel and add it to your canvas.
  61. 3. **Start the Python MCP Bridge Server**
  62. Open a terminal and run:
  63. ```
  64. python -m grasshopper_mcp.bridge
  65. ```
  66. > **Note**: The command `grasshopper-mcp` might not work directly due to Python script path issues. Using `python -m grasshopper_mcp.bridge` is the recommended and more reliable method.
  67. 4. **Connect Claude Desktop to the MCP Bridge**
  68. **Method 1: Manual Connection**
  69. In Claude Desktop, connect to the MCP Bridge server using the following settings:
  70. - Protocol: MCP
  71. - Host: localhost
  72. - Port: 8080
  73. **Method 2: Configure Claude Desktop to Auto-Start the Bridge**
  74. You can configure Claude Desktop to automatically start the MCP Bridge server by modifying its configuration:
  75. ```json
  76. "grasshopper": {
  77. "command": "python",
  78. "args": ["-m", "grasshopper_mcp.bridge"]
  79. }
  80. ```
  81. This configuration tells Claude Desktop to use the command `python -m grasshopper_mcp.bridge` to start the MCP server.
  82. 5. **Start Using Grasshopper with Claude Desktop**
  83. You can now use Claude Desktop to control Grasshopper through natural language commands.
  84. ## Example Commands
  85. Here are some example commands you can use with Claude Desktop:
  86. - "Create a circle with radius 5 at point (0,0,0)"
  87. - "Connect the circle to a extrude component with a height of 10"
  88. - "Create a grid of points with 5 rows and 5 columns"
  89. - "Apply a random rotation to all selected objects"
  90. ## Troubleshooting
  91. If you encounter issues, check the following:
  92. 1. **GH_MCP Component Not Loading**
  93. - Ensure the .gha file is in the correct location
  94. - In Grasshopper, go to File > Preferences > Libraries and click "Unblock" to unblock new components
  95. - Restart Rhino and Grasshopper
  96. 2. **Bridge Server Won't Start**
  97. - If `grasshopper-mcp` command doesn't work, use `python -m grasshopper_mcp.bridge` instead
  98. - Ensure all required Python dependencies are installed
  99. - Check if port 8080 is already in use by another application
  100. 3. **Claude Desktop Can't Connect**
  101. - Ensure the bridge server is running
  102. - Verify you're using the correct connection settings (localhost:8080)
  103. - Check the console output of the bridge server for any error messages
  104. 4. **Commands Not Executing**
  105. - Verify the GH_MCP component is on your Grasshopper canvas
  106. - Check the bridge server console for error messages
  107. - Ensure Claude Desktop is properly connected to the bridge server
  108. ## Development
  109. ### Project Structure
  110. ```
  111. grasshopper-mcp/
  112. ├── grasshopper_mcp/ # Python bridge server
  113. │ ├── __init__.py
  114. │ └── bridge.py # Main bridge server implementation
  115. ├── GH_MCP/ # Grasshopper component (C#)
  116. │ └── ...
  117. ├── releases/ # Pre-compiled binaries
  118. │ └── GH_MCP.gha # Compiled Grasshopper component
  119. ├── setup.py # Python package setup
  120. └── README.md # This file
  121. ```
  122. ### Contributing
  123. Contributions are welcome! Please feel free to submit a Pull Request.
  124. ## License
  125. This project is licensed under the MIT License - see the LICENSE file for details.
  126. ## Acknowledgments
  127. - Thanks to the Rhino and Grasshopper community for their excellent tools
  128. - Thanks to Anthropic for Claude Desktop and the MCP protocol
  129. ## Contact
  130. For questions or support, please open an issue on the GitHub repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.