Rhinomcpserver

🚀 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]

開發

項目結構

• combined_mcp_server.py：主要的 MCP 服務器實現文件
• diagnose_rhino_connection.py：用於測試 Rhino 連接的診斷工具
• log_manager.py：用於管理和分析日誌的工具
• server_launcher.sh：啟動任何服務器實現的統一腳本
• logs/：包含所有日誌文件的目錄