GrasshopperCAUTION
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Grasshopper MCP Bridge is a bridging server that connects Grasshopper and Claude Desktop using the Model Context Protocol (MCP) standard.
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
The system consists of the following parts:
- Grasshopper MCP Component (GH_MCP.gha): A plugin installed in Grasshopper that provides a TCP server to receive commands
- Python MCP Bridge Server: A bridge server that connects Claude Desktop and the Grasshopper MCP component
- 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
- Install the Grasshopper MCP Component
Method 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:
%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.
- 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
330a3642a9efOBSERVED · 2026-10-07Exposed tools (14)
10 read · 3 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
add_component | write | |
clear_document | destructive | Clear the Grasshopper document |
connect_components | read | |
create_pattern | write | |
get_all_components | read | |
get_available_patterns | read | |
get_component_info | read | |
get_component_parameters | read | |
get_connections | read | |
get_document_info | read | Get information about the Grasshopper document |
load_document | read | |
save_document | write | |
search_components | read | |
validate_connection | read |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (2)
GH_MCP.gha
clear_document
Gates applied: no_behavioural_pass.
330a3642a9effull audit observations/trust-audit/mcp-server/alfredatnycu__grasshopper.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 330a3642a9ef | CAUTION | B | 89 | first audit |
Questions
What tools does Grasshopper expose?
14 in total: 10 read-only, 3 that write, and 1 that can delete or overwrite (clear_document). Every one is listed on this page with its risk.
Is Grasshopper safe to connect to an agent?
With care. The audit graded it B (89/100) and found 2 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Grasshopper need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (330a3642a9ef), read on 2026-10-07. The repository is watched and re-audited when it changes.