Grasshopper MCP Bridgeは、Model Context Protocol(MCP)標準を用いてGrasshopperとClaude Desktopを接続するブリッジサーバーです。

特徴

• GrasshopperとClaude DesktopをMCPプロトコル経由で接続
• Grasshopperコンポーネントの作成と接続のための直感的なツール機能を提供します
• 高レベルの意図認識をサポートし、単純な記述から複雑なコンポーネントパターンを自動的に作成します
• 共通コンポーネントのパラメータや接続ルールを理解するコンポーネントナレッジベースを含む
• Claude Desktopが正しくコンポーネントを接続するためのコンポーネントガイダンスリソースを提供します

システムアーキテクチャ

このシステムは以下の部分で構成されています。

1. Grasshopper MCP コンポーネント(GH_MCP.gha):Grasshopperにインストールされたプラグインで、コマンドを受信するためのTCPサーバーを提供します
2. Python MCP Bridge Server:Claude DesktopとGrasshopper MCPコンポーネントを接続するブリッジサーバー
3. コンポーネントナレッジベース:コンポーネント情報、パターン、意図を含むJSONファイル

取り付け手順

前提条件

• ライノ7以上
• バッタ
• Python 3.8以上
• クロードデスクトップ

設置手順

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: