Rhinomcpserver

Rhino 3D的MCP服务器实现项目，允许AI通过模型上下文协议创建和操作3D对象，包含Python和C#组件，目前处于开发阶段。

开发者工具图像与视频处理 #3D建模 #AI交互 #Rhino插件 #协议开发 .C#

评分 : 2.5分

下载量 : 7.5K

更新时间 : 2025-04-29

打开站点

什么是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]