使用说明

项目简介

Rhino MCP 服务器是为 Rhino 3D 建模软件设计的 MCP (Model Context Protocol) 服务器实现。它允许 AI 助手（如 Claude）通过标准化的 MCP 协议与 Rhino 3D 进行通信，从而实现通过自然语言指令在 Rhino 中创建、修改和查询 3D 模型。该服务器充当桥梁，使得 AI 助手能够理解用户对 3D 建模的意图，并将其转化为 Rhino 3D 的具体操作。

主要功能点

3D 对象创建: 支持创建基本的 3D 几何体，包括球体 (sphere)、立方体 (box) 和圆柱体 (cylinder)，并允许指定位置、尺寸和颜色等参数。
场景信息查询: 能够获取当前 Rhino 场景的信息，例如场景中对象的数量、图层信息等，为 AI 助手提供上下文感知能力。
场景管理: 支持清除 Rhino 场景中的所有对象或仅清除当前图层的对象，方便场景的重置和清理。
图层管理: 允许在 Rhino 文档中创建新的图层，并可以指定图层的名称和颜色，有助于组织和管理 3D 模型。
详细日志记录: 具备完善的日志系统，可以记录服务器、插件和 Claude AI 的交互日志，方便问题追踪和调试。

安装步骤

安装 Claude Desktop: 如果尚未安装 Claude Desktop 客户端，请先下载并安装。
配置 MCP 服务器连接: 在 Claude Desktop 的设置中，找到 MCP 服务器连接配置项，按照以下 “服务器配置” 部分的说明进行配置。
运行 Rhino MCP 服务器: 根据您的需求选择以下服务器运行方式之一：
- 方式一：组合 MCP 服务器 (推荐) 打开终端，导航到 'rhinoMcpServer' 仓库目录，执行以下命令启动组合服务器：
```
./run-combined-server.sh
```
  此方式服务器通过标准输入/输出 (stdin/stdout) 与 Claude Desktop 通信，无需额外的 socket 连接。
- 方式二：Socket 服务器 首先，启动后台守护进程服务器：
```
./daemon_mcp_server.py
```
  然后，在 Claude Desktop 的 MCP 服务器连接配置中，指定使用 socket 代理：
```
./socket_proxy.py
```
  此方式使用 socket 连接，允许后台服务器持续运行，并通过 socket 代理与 Claude Desktop 进行通信。
- 方式三：独立服务器 执行以下命令启动独立的 Python 服务器：
```
./run-python-server.sh
```
  此方式为原始的独立服务器实现。

服务器配置

以下 JSON 配置信息用于配置 MCP 客户端（如 Claude Desktop）连接到 Rhino MCP 服务器。请根据您选择的服务器运行方式，选择相应的配置并填入 MCP 客户端的服务器配置中。

推荐配置：组合 MCP 服务器

{
  "serverName": "RhinoMCP",  // 服务器名称，可自定义
  "command": "./run-combined-server.sh", // 组合服务器启动命令 (请确保 Claude 客户端能找到此脚本的相对或绝对路径)
  "args": [], // 启动参数，组合服务器无需额外参数
  "transport": "stdio" // 通信方式，组合服务器使用 stdio
}

其他配置 (Socket 服务器或独立服务器)

如果您选择使用 Socket 服务器或独立服务器，请根据 README.md 中的说明进行配置，并相应修改 'command' 和 'args' 字段。

基本使用方法

确保 Rhino 3D 软件已安装并运行。
启动 Rhino MCP 服务器（选择上述安装步骤中的一种方式）。
在 Claude Desktop 中配置并连接到 Rhino MCP 服务器。
在 Claude Desktop 中，您可以向 Claude 发出自然语言指令，例如：
- "创建一个红色的球体，半径为 5，中心坐标为 (10, 10, 10)"
- "清除场景中的所有物体"
- "创建一个名为 '结构' 的新图层"
- "获取当前场景的信息"

Claude 将会调用 Rhino MCP 服务器提供的工具，在 Rhino 3D 中执行相应的操作，并返回结果。

注意: 首次使用或遇到连接问题时，请参考仓库 README.md 中的 “Setup Instructions” 和 “Troubleshooting” 部分进行更详细的配置和问题排查。

关键词

使用说明

信息