Atlas / MCP servers / veoery / GH

GHBLOCK

mcp/veoery/gh

This is a MCP Server that allows LLM to interact with Rhino and Grasshopper directly.

Verdict
BLOCK
Grade
F
Trust score
58 /100
Exposed tools
12 6r · 6w · 0d
Transport
—
License
MIT
Stars
32
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

GHmcpserver provides an approach that allows designer to interact with Rhino and Grasshopper directly via LLMs, including to analyse .3dm file, do 3D modeling and generate GHPython automatically in Grasshopper based on user’s guidance.

This project is still under construction — and we’d love your help! - Feel free to open an issue if you encounter bugs or have ideas. - Pull requests are always welcome. - If you're interested in collaborating long-term, feel free to reach out to [email protected] — we’d love to have you on the team!

Requirements

  • Rhino 7 or 8
  • Install RhinoPython: https://github.com/jingcheng-chen/RhinoPythonForVscode/tree/master?tab=readme-ov-file
  • uv
  • ```

For MacOS and Linux

curl -LsSf https://astral.sh/uv/install.sh | sh


- ``````
# For Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Claude Desktop

Installation

1. Clone the repository

git clone [email protected]:veoery/GH_mcp_server.git
cd GH_mcp_server

2. Set up the environment

We recommend using uv:

macOS/Linux

uv venv
source .venv/bin/activate
uv pip install -e .

Windows

uv venv
.venv\Scripts\activate
uv pip install -e .
Make sure the virtual environment is activated before running or developing the project.

3. Configuration

  1. In the Claude Desktop, Navigate to Settings->Developer. You will see ``Edit Config``.
  1. Click the ``Edit Config` and open the file `claude_desktop_config.json``
  1. Place the following code to the json file:
{
"mcpServers": {
"grasshopper": {
"command": "path_to_GH_mcp_server/.venv/bin/python",
"args": [
"path_to_GH_mcp_server/run_server.py"
]
}
}
}
  1. Restart the Claude Desktop. If you are able to see a hammer icon, the co
Read from source at commit b7d61d6cc471OBSERVED · 2026-10-08
Advertisement
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add grasshopper-mcp --env COMPUTE_API_KEY=${COMPUTE_API_KEY} -- uvx grasshopper-mcp
claude-desktop
{
  "mcpServers": {
    "grasshopper-mcp": {
      "command": "uvx",
      "args": [
        "grasshopper-mcp"
      ],
      "env": {
        "COMPUTE_API_KEY": "${COMPUTE_API_KEY}"
      }
    }
  }
}
03

Exposed tools (12)

6 read · 6 write · 0 destructive.

ToolRiskDescription
add_grasshopper_componentwriteAdd a component from an existing Grasshopper plugin.
analyze_rhino_filereadAnalyze a Rhino (.3dm) file.
call_grasshopper_pluginreadCall a specific component from a Grasshopper plugin.
connect_grasshopper_componentsreadConnect parameters between Grasshopper components.
create_parametric_definitionwriteCreate a complete parametric definition in Grasshopper based on a description.
edit_gh_script_componentwriteEdit the code in an existing Python script component.
execute_grasshopper_codewriteExecute given Python code.
extract_geometryreadExtract geometric data from an existing object.
generate_rhino_codewriteGenerate and execute Rhino Python code based on a description.
list_objectsreadList all objects in a Rhino file.
measure_distancereadMeasure the distance between two objects in a Rhino file.
run_grasshopper_definitionwriteRun a Grasshopper definition.
04

Trust audit

BLOCKgrade F · trust 58/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryFAIL
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)FAIL
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
none-observed
Network
declared (5 observation(s))
Shell
declared (2 observation(s))
Dependencies
pinned
Secrets in source
found

Findings (13)

HIGHHard-coded secrets · inv.env_committed · CWE-798, CWE-321
.env
.env
Why it matters. a real .env in the package
Fix. ship .env.example with placeholders only
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
grasshopper_mcp/rhino/connection.py:400
exec(code, globals_dict, locals_dict)
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
grasshopper_mcp/rhino/connection.py:424
exec(code, globals_dict, locals_dict)
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHPrompt injection · prompt.zero_width · CWE-94, CWE-1427
README.md:104
Why it matters. invisible characters in instruction text
Fix. strip non-printing characters
MEDIUMInventory / provenance · inv.binary · CWE-1104
.DS_Store
.DS_Store
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.binary · CWE-1104
examples/test01.gh
test01.gh
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.binary · CWE-1104
examples/test02.gh
test02.gh
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.binary · CWE-1104
examples/test03.gh
test03.gh
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.binary · CWE-1104
examples/test_rhino3dm.3dm
test_rhino3dm.3dm
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.hidden_file · CWE-1104
.DS_Store
.DS_Store
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
.env
.env
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
grasshopper_mcp/.DS_Store
.DS_Store
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
INFOSupply chain · prompt.pipe_to_shell · CWE-829, CWE-1357
README.md:23
curl -LsSf https://astral.sh/uv/install.sh | sh

Gates applied: no_behavioural_pass.

Audited 2026-10-08 · audit v0.4.1 · source sha b7d61d6cc471full audit observations/trust-audit/mcp-server/veoery__gh.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-08b7d61d6cc471BLOCKF58first audit
06

Questions

What is the GH MCP server?

This is a MCP Server that allows LLM to interact with Rhino and Grasshopper directly.

What tools does GH expose?

12 in total: 6 read-only, 6 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is GH safe to connect to an agent?

No — not without reading the findings first. The audit graded it F (58/100) and found 4 critical or high issues in the source. Each one is listed on this page with the file and line it is on.

What credentials does GH need?

It reads COMPUTE_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How current is this page?

The grade is for one exact copy of the source (b7d61d6cc471), read on 2026-10-08. The repository is watched and re-audited when it changes.

Advertisement