Rhino3d

🚀 RhinoMCP

RhinoMCP通過模型上下文協議（MCP）將Rhino3D與Claude AI連接起來，使Claude能夠直接與Rhino3D進行交互和控制，從而實現AI輔助的三維建模、分析和設計工作流程。

🚀 快速開始

RhinoMCP將Rhino3D與Claude AI集成，實現AI輔助的三維建模等工作流程。下面為你介紹具體的使用步驟。

✨ 主要特性

• 基於套接字的雙向通信，在Python和Rhino之間實現交互。
• 支持Claude AI通過MCP協議與Rhino插件的集成。
• 支持NURBS曲線創建（初始測試功能）。
• 在Rhino上下文中執行Python腳本的能力。
• 兼容Claude Desktop和Windsurf作為客戶端。

📦 安裝指南

要求

• Rhinoceros 3D（版本7或8）
• Python 3.10或更高版本
• Windows 10或11

使用uv安裝（推薦）

# 創建並激活虛擬環境 
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 安裝包
uv pip install -e .

使用pip安裝

# 創建並激活虛擬環境
python -m venv .venv
.venv\Scripts\activate  # 在Windows中使用

# 安裝包
pip install -e .

💻 使用示例

基礎用法

步驟1：啟動Rhino橋接服務器

1. 打開Rhino。
2. 在命令行中輸入EditPythonScript以打開Rhino的Python編輯器。
3. 從src/rhino_plugin/rhino_server.py打開Rhino服務器腳本。
4. 運行腳本（F5或單擊“運行”按鈕）。
5. 確認在輸出面板中看到“Rhino橋接已啟動！”

步驟2：啟動MCP服務器

# 激活您的虛擬環境
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 啟動MCP服務器
rhinomcp

或者使用自定義設置運行：

rhinomcp --host 127.0.0.1 --port 5000 --rhino-host 127.0.0.1 --rhino-port 8888 --debug

步驟3：與Claude Desktop或Windsurf連接

將Claude Desktop或Windsurf配置為連接到MCP服務器的地址：

ws://127.0.0.1:5000

高級用法

示例：創建NURBS曲線

在與Claude連接後，您可以請求它在Rhino中使用以下提示創建一條NURBS曲線：

在Rhino中使用點（0,0,0）、（5,10,0）、（10,0,0）和（15,10,0）創建一條NURBS曲線。

📚 詳細文檔

項目概述

此集成包含兩個主要組件：

1. Rhino插件：在Rhino的Python編輯器內部運行的套接字服務器，提供與Rhino功能之間的通信接口。
2. MCP服務器：實現模型上下文協議（MCP）的服務器，將Claude AI連接到Rhino插件，從而實現AI控制的操作。

開發

設置開發環境

# 克隆倉庫
git clone https://github.com/FernandoMaytorena/RhinoMCP.git
cd RhinoMCP

# 創建並激活虛擬環境
mkdir -p .venv
python -m venv .venv
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 安裝依賴項
pip install -r requirements.txt

# 運行測試
pytest tests/

項目結構

RhinoMCP/
├── src/
│   ├── rhino_plugin/       # Rhino插件代碼
│   └── mcp_server/        # MCP服務器代碼
├── requirements.txt      # 項目依賴項列表
└── README.md             # 項目文檔

貢獻

我們歡迎社區貢獻！請參考CONTRIBUTING.md瞭解如何參與。

📄 許可證

該項目受MIT License的保護。