Grasshopper MCP Bridge — это мостовой сервер, который соединяет Grasshopper и Claude Desktop по стандарту Model Context Protocol (MCP).

Особенности

• Соединяет Grasshopper и Claude Desktop через протокол MCP
• Предоставляет интуитивно понятные функции инструментов для создания и соединения компонентов Кузнечика
• Поддерживает высокоуровневое распознавание намерений, автоматически создавая сложные шаблоны компонентов из простых описаний
• Включает базу знаний компонентов, понимающую параметры и правила соединения для обычных компонентов
• Предоставляет ресурсы по инструкциям по компонентам для корректного соединения компонентов Claude Desktop

Архитектура системы

Система состоит из следующих частей:

1. Компонент MCP Grasshopper (GH_MCP.gha): Плагин, установленный в Grasshopper, который предоставляет TCP-сервер для получения команд
2. Python MCP Bridge Server: мостовой сервер, соединяющий Claude Desktop и компонент Grasshopper MCP
3. База знаний компонентов: JSON-файлы, содержащие информацию о компонентах, шаблоны и намерения

Инструкции по установке

Требования

• Rhino 7 или выше
• Кузнечик
• Python 3.8 или выше
• Claude Desktop

Этапы установки

Grasshopper MCP Bridge

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:

1. Grasshopper MCP Component (GH_MCP.gha): A plugin installed in Grasshopper that provides a TCP server to receive commands
2. Python MCP Bridge Server: A bridge server that connects Claude Desktop and the Grasshopper MCP component
3. 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

1. 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.

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/[email protected]
   

Usage

1. Start Rhino and Grasshopper

   Launch Rhino and open Grasshopper.

2. Add the GH_MCP Component to Your Canvas

   Find the GH_MCP component in the Grasshopper component panel and add it to your canvas.

3. Start the Python MCP Bridge Server

   Open a terminal and run: