jingcheng-chen/rhinomcp

RhinoMCP – AI 驅動的 Rhino 3D 與 Grasshopper 控制

是什麼 – 一個小型開源橋接工具，讓大型語言模型代理（Claude、Cursor、Codex 等）能與 Rhino 3D 及其視覺化程式設計環境 Grasshopper 通訊。它實作了 Model Context Protocol（MCP），讓 AI 可以以自然語言發出高階指令，並從 Rhino 視口接收視覺回饋。

主要功能

• 幾何創建與編輯 – 點、曲線、曲面、實體、布林運算、放樣、掃掠等，可逐一或批量處理。
• 場景檢視 – 查詢物件清單、屬性、圖層，或擷取目前視口的螢幕截圖，讓模型「看見」當前狀態。
• Grasshopper 編程 – 搜尋元件、新增至畫布、連接參數、設定滑桿值、執行求解器，或單次呼叫重建整個定義。
• 底層存取 – 可執行任何原生 Rhino 命令、執行 RhinoScript-Python 程式碼，或執行 RhinoCommon C# 程式碼（可選開關以停用這些強大工具）。
• 雙向互動 – AI 既能產生幾何，也能讀取模型狀態，支援迭代式設計循環。

運作方式

1. Python MCP 伺服器（PyPI 上的 rhinomcp）在本機執行，透過標準 MCP stdio 接口公開工具集。
2. Rhino 插件（透過 Rhino 的套件管理員安裝）在 Rhino 內部啟動一個 TCP 監聽器（預設 127.0.0.1:1999）。
3. AI 客戶端將伺服器註冊為 MCP 端點（rhino），並傳送 JSON 編碼的工具呼叫；插件在主 Rhino 線程上執行這些呼叫並回傳結果。

快速上手

1. 透過套件管理員安裝 Rhino 插件（rhinomcp）。
2. 使用 uvx rhinomcp@latest 安裝 Python 伺服器（或透過 pip install rhinomcp）。
3. 將伺服器加入 AI 客戶端的 MCP 設定中（例如：codex mcp add rhino …）。
4. 在 Rhino 中執行命令 mcpstart 以開啟 TCP 橋接。
5. 與你的助手對話：要求它「建立一個 6×6×6 的盒子網格，顏色由藍色漸變至紅色」或「建構一個 Grasshopper 圖形，使圓柱體的高度隨距離某一點的距離而變化」。

適用對象 – 已使用 Rhino 8 並希望嘗試 AI 輔助建模或自動化 Grasshopper 工作流程的設計師、建築師、工程師或開發者。也適用於建構自主設計代理的研究人員。

專案狀態 – 活躍維護中（PyPI 發布、透過套件管理員更新 Rhino 插件）。倉儲包含 Python 測試套件、C# 建構腳本，以及擴充工具集的文件。

授權 – MIT。