Rhino 3D

🚀 Rhino MCP 服務器

該項目旨在通過 MCP 協議實現 Rhino 3D 的 AI 輔助建模功能，允許用戶藉助 AI 助手創建和操作 3D 對象，不過目前仍在開發中。

🚀 快速開始

目前項目處於積極開發階段，尚未正常運行，Rhino 插件在創建對象時存在問題。我們正積極尋求社區幫助，尤其是熟悉 Rhino API、C# 插件或 MCP 集成的開發者。

✨ 主要特性

• 通過 MCP 協議實現 Rhino 3D 的 AI 輔助建模功能。
• 允許用戶通過 AI 助手（如 Claude）創建和操作 3D 對象。
• 採用統一的日誌框架，方便對各組件進行日誌查看、分析和報告生成。

🔧 技術細節

系統架構

項目結構如下：

1. Python 腳本：
   • combined_mcp_server.py：主 MCP 服務器實現。
   • diagnose_rhino_connection.py：用於測試 Rhino 連接狀態的診斷工具。
   • log_manager.py：管理日誌文件並提供分析功能。
2. Shell 腳本：
   • server_launcher.sh：統一啟動腳本，支持多種服務器模式。
3. 目錄結構：
   • logs/：存儲所有組件的日誌文件。

功能模塊

1. MCP 服務器實現

• combined_mcp_server.py：核心服務器實現，支持以下工具：
  • geometry_tools.create_sphere：創建指定中心和半徑的球體。
  • geometry_tools.create_box：創建指定尺寸的長方體。
  • geometry_tools.create_cylinder：創建指定參數的圓柱體。
  • scene_tools.get_scene_info：獲取當前場景信息。
  • scene_tools.clear_scene：清除場景中的所有對象。
  • scene_tools.create_layer：在文檔中創建新圖層。

2. 插件開發

• Rhino 插件：負責與 Rhino 的交互，目前存在對象創建失敗的問題，需進一步調試和修復。

日誌系統

項目採用統一的日誌框架，記錄服務器日誌、插件日誌、AI 工作站日誌和診斷日誌。所有日誌按組件分類存儲於 logs/ 目錄，並遵循一致的格式。通過 log_manager.py 可實現日誌查看、分析和報告生成。

📚 詳細文檔

開發指南

項目結構

.
├── combined_mcp_server.py       # 主 MCP 服務器實現。
├── diagnose_rhino_connection.py # 測試 Rhino 連接狀態的診斷工具。
├── log_manager.py               # 日誌管理工具。
└── server_launcher.sh           # 統一啟動腳本。

添加新功能

1. 新增工具：
   • 將新功能方法添加至 combined_mcp_server.py。
   • 確保遵循現有日誌記錄規範。
2. 診斷與修復：
   • 使用 diagnose_rhino_connection.py 測試插件與 Rhino 的連接狀態。
   • 修復當前存在的對象創建問題，確保插件穩定運行。
3. 日誌管理：
   • 更新日誌框架以支持新功能模塊。
   • 確保所有日誌輸出遵循統一格式。

故障排除

常見問題

1. 連接失敗：
   • 檢查是否有舊進程佔用端口或資源。
   • 使用 server_launcher.sh help 重啟相關服務。
2. 日誌分析：
   • 查看 logs/ 目錄中的詳細日誌以定位問題。
   • 使用 log_manager.py report 生成錯誤報告。
3. 插件調試：
   • 在 Rhino 中啟用開發者模式，檢查插件加載狀態。
   • 確保所有 API 調用正確無誤。

📄 許可證

本項目遵循 MIT License 協議，具體內容見 LICENSE 文件。

⚠️ 重要提示

該項目目前處於積極開發階段，尚未正常運行。Rhino 插件在創建對象時存在問題。我們正在積極尋求社區的幫助，尤其是熟悉 Rhino API、C# 插件或 MCP 集成的開發者。