Grasshopper Parametric Design

🚀 蟈蟈 MCP 橋接服務器

蟈蟈 MCP 橋接服務器是一個連接 Grasshopper 和 Claude Desktop 的中轉服務器，採用模型上下文協議（MCP）標準，能有效搭建起兩者之間的通信橋樑，為用戶帶來便捷的使用體驗。

🚀 快速開始

Grasshopper MCP Bridge 可通過 MCP 協議將 Grasshopper 和 Claude Desktop 連接起來，以下是啟動橋接服務器並連接到 Claude Desktop 的步驟：

啟動橋接服務器

在 Grasshopper 的命令行界面中輸入以下命令：

import sys
sys.path.append(r"你的路徑\grasshopper-mcp\grasshopper_mcp")
import bridge
bridge.start()

連接到 Claude Desktop

1. 打開 Claude 桌面版。
2. 轉到 編輯 > 首選項 > 網絡設置。
3. 輸入地址：http://localhost:8080。
4. 保存設置並重新啟動 Claude。

✨ 主要特性

• 通過 MCP 協議將 Grasshopper 和 Claude Desktop 連接起來。
• 提供直觀的工具功能，用於創建和連接 Grasshopper 組件。
• 支持高級意圖識別，可根據簡單描述自動生成複雜組件模式。
• 包含適用於所有組件的預設庫。
• 附帶詳細說明文檔。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/grasshopper-mcp.git
cd grasshopper-mcp

安裝 Python 依賴項

pip install -r requirements.txt

編譯 Grasshopper 組件

// 在 GH_MCP 文件夾中打開 Visual Studio 項目並進行編譯

啟動橋接服務器

python grasshopper_mcp/bridge.py

📚 詳細文檔

系統架構

grasshopper-mcp/
├── grasshopper_mcp/       # Python 橋接服務器
│   ├── __init__.py
│   └── bridge.py          # 主橋接服務器實現
├── GH_MCP/                # Grasshopper 組件 (C#)
│   └── ...
├── releases/              # 預編譯二進制文件
│   └── GH_MCP.gha         # 編譯好的 Grasshopper 組件
├── setup.py               # Python 包設置
└── README.md              # 本文件

項目結構

grasshopper-mcp/
├── grasshopper_mcp/       # Python 橋接服務器
│   ├── __init__.py
│   └── bridge.py          # 主橋接服務器實現
├── GH_MCP/                # Grasshopper 組件 (C#)
│   └── ...
├── releases/              # 預編譯二進制文件
│   └── GH_MCP.gha         # 編譯好的 Grasshopper 組件
├── setup.py               # Python 包設置
└── README.md              # 本文件

故障排除

問題1：Grasshopper 組件未加載

• 確保 .gha 文件位於正確位置。
• 在 Grasshopper 中，轉到 文件 > 首選項 > 庫 並點擊“解除阻止”以解除新組件的限制。
• 重啟 Rhino 和 Grasshopper。

問題2：橋接服務器無法啟動

• 如果命令無效，請使用 python -m grasshopper_mcp.bridge 替代。
• 確保所有 Python 依賴項已安裝。
• 檢查端口 8080 是否被其他程序佔用。

如何貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

本項目 licensed under the MIT License，具體內容請參見 LICENSE 文件。

致謝

• 感謝 Rhino 和 Grasshopper 社區提供的優秀工具。
• 感謝 Anthropic 提供的 Claude Desktop 和 MCP 協議。