什麼是Rhino MCP服務器？

Rhino MCP服務器是一個連接AI助手（如Claude）與Rhino 3D軟件的橋樑，允許用戶通過自然語言指令直接創建和操控3D模型。

如何使用Rhino MCP服務器？

您可以通過啟動服務器，配置Claude Desktop，併發送指令來創建和管理3D對象。

適用場景

適用於建築師、設計師和工程師，希望快速生成3D模型或進行設計迭代。

主要功能

創建球體根據指定中心點和半徑創建一個球體。

創建立方體根據指定尺寸創建一個立方體。

創建圓柱體根據指定參數創建一個圓柱體。

獲取場景信息返回當前場景中的對象、圖層和其他相關信息。

清空場景清除當前場景中的所有對象。

創建新圖層在文檔中創建一個新的圖層。

優勢與侷限性

優勢

通過自然語言輕鬆創建複雜3D模型。

支持多種幾何體和工具，滿足多樣化需求。

強大的日誌系統便於問題排查和調試。

侷限性

需要安裝Rhino 3D軟件和Claude Desktop。

當前版本仍在開發中，部分功能可能不穩定。

對網絡環境有一定要求，確保通信順暢。

如何使用

安裝Rhino 3D和Claude Desktop

確保已安裝最新版本的Rhino 3D和Claude Desktop。

啟動Rhino MCP服務器

運行`./server_launcher.sh combined`啟動默認的MCP服務器。

配置Claude Desktop

在Claude Desktop設置中添加MCP服務器地址。

發送指令

例如：`create_sphere(center=[0,0,0], radius=5)`。

使用案例

創建一個球體通過指令創建一個位於原點且半徑為5的球體。

清空場景清除當前場景中的所有對象。

常見問題

如何解決連接失敗的問題？

如何查看日誌文件？

服務器運行時出錯怎麼辦？

🚀 Rhino MCP 服務器

本項目為 Rhino 3D 打造了 Model Context Protocol (MCP) 服務器，藉助該服務器，像 Claude 這類 AI 助手能夠通過 Model Context Protocol 與 Rhino 進行交互，實現從 AI 接口直接創建和操作 3D 對象。

⚠️ 重要提示

該項目目前處於積極開發階段，尚未正常工作。Rhino 插件在創建對象時遇到問題。我們正在積極尋求社區的支持以幫助解決這些問題。如果您有使用 Rhino API 開發、C# 插件或 MCP 集成的經驗，請考慮貢獻代碼。如需聯繫，請在 GitHub 上打開問題報告。

✨ 主要特性

為 Rhino 3D 實現 MCP 服務器，讓 AI 助手可通過 MCP 與 Rhino 交互。
支持從 AI 接口直接創建和操作 3D 對象。

📚 詳細文檔

系統架構

系統由 Python 組件實現 MCP 服務器以及 C# 組件與 Rhino 集成。以下是系統組件的交互概述：

graph TD
    %% 客戶端應用程序
    client[客戶端應用程序] --> socketProxy
    
    %% Socket 代理
    subgraph "Python Socket 代理"
        socketProxy[socket_proxy.py] --> daemonServer
    end
    
    %% 守護服務器
    subgraph "Python 守護服務器"
        daemonServer[daemon_mcp_server.py] --> combinedServer
    end
    
    %% 組合 MCP 服務器
    subgraph "Python 組合 MCP 服務器"
        combinedServer[combined_mcp_server.py]
        mcp[FastMCP] --> tools
        combinedServer --> mcp
        combinedServer --> rhinoConn
        subgraph "MCP 工具"
            tools[MCP 工具方法]
        end
        rhinoConn[RhinoConnection]
    end
    
    %% Rhino 插件組件
    subgraph "C# Rhino 插件"
        rhinoPlugin[RhinoMcpPlugin.cs]
        socketServer[RhinoSocketServer.cs]
        utilities[RhinoUtilities.cs]
        commands[RhinoMcpCommand.cs]
        
        rhinoPlugin --> socketServer
        rhinoPlugin --> commands
        socketServer --> utilities
    end
    
    %% 組件間的連接
    rhinoConn <==> socketServer
    
    %% 日誌組件
    subgraph "日誌系統"
        logManager[log_manager.py]
        nlogConfig[NLog.config]
    end
    
    combinedServer --> logManager
    rhinoPlugin --> nlogConfig
    
    %% Rhino 程序
    rhino[Rhino.exe]