Rhinomcpserver

🚀 Rhino MCP Server

A Model Context Protocol (MCP) server for Rhino 3D, enabling AI assistants like Claude to interact with Rhino via the Model Context Protocol. This server makes it possible to directly create and manipulate 3D objects from AI interfaces.

🚀 Quick Start

⚠️ Important Note

This project is currently in active development and is not yet fully functional. The Rhino plugin encounters issues when creating objects. We are actively seeking community support to help resolve these problems. If you have experience in developing with the Rhino API, creating C# plugins, or integrating MCP, please consider contributing code. To get in touch, open an issue report on GitHub.

✨ Features

This server allows AI assistants such as Claude to interact with Rhino through the Model Context Protocol, enabling the direct creation and manipulation of 3D objects from AI interfaces.

🔧 Technical Details

System Architecture

The system consists of a Python component implementing the MCP server and a C# component integrating with Rhino. Here is an overview of the interaction between system components:

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]

Development

Project Structure

• combined_mcp_server.py: The main implementation file of the MCP server.
• diagnose_rhino_connection.py: A diagnostic tool for testing the Rhino connection.
• log_manager.py: A tool for managing and analyzing logs.
• server_launcher.sh: A unified script for launching any server implementation.
• logs/: A directory containing all log files.