RhinoMCP

RhinoMCP将Rhino3D与Claude AI通过模型上下文协议（MCP）连接起来，使Claude能够直接交互并控制Rhino3D，从而实现AI辅助的三维建模、分析和设计工作流程。

项目概述

此集成包含两个主要组件：

1. Rhino插件：在Rhino的Python编辑器内部运行的套接字服务器，提供与Rhino功能之间的通信接口。
2. MCP服务器：实现模型上下文协议（MCP）的服务器，将Claude AI连接到Rhino插件，从而实现AI控制的操作。

功能

• 基于套接字的双向通信，在Python和Rhino之间实现交互
• 支持Claude AI通过MCP协议与Rhino插件的集成
• 支持NURBS曲线创建（初始测试功能）
• 在Rhino上下文中执行Python脚本的能力
• 兼容Claude Desktop和Windsurf作为客户端

安装

要求

• Rhinoceros 3D（版本7或8）
• Python 3.10或更高版本
• Windows 10或11

使用uv安装（推荐）

# 创建并激活虚拟环境 
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 安装包
uv pip install -e .

使用pip安装

# 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate  # 在Windows中使用

# 安装包
pip install -e .

使用方法

步骤1：启动Rhino桥接服务器

1. 打开Rhino
2. 在命令行中输入EditPythonScript以打开Rhino的Python编辑器
3. 从src/rhino_plugin/rhino_server.py打开Rhino服务器脚本
4. 运行脚本（F5或单击“运行”按钮）
5. 确认在输出面板中看到“Rhino桥接已启动！”

步骤2：启动MCP服务器

# 激活您的虚拟环境
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 启动MCP服务器
rhinomcp

或者使用自定义设置运行：

rhinomcp --host 127.0.0.1 --port 5000 --rhino-host 127.0.0.1 --rhino-port 8888 --debug

步骤3：与Claude Desktop或Windsurf连接

将Claude Desktop或Windsurf配置为连接到MCP服务器的地址：

ws://127.0.0.1:5000

示例：创建NURBS曲线

在与Claude连接后，您可以请求它在Rhino中使用以下提示创建一条NURBS曲线：

在Rhino中使用点（0,0,0）、（5,10,0）、（10,0,0）和（15,10,0）创建一条NURBS曲线。

开发

设置开发环境

# 克隆仓库
git clone https://github.com/FernandoMaytorena/RhinoMCP.git
cd RhinoMCP

# 创建并激活虚拟环境
mkdir -p .venv
python -m venv .venv
source .venv/Scripts/activate  # 在Windows的Git Bash中使用

# 安装依赖项
pip install -r requirements.txt

# 运行测试
pytest tests/

项目结构

RhinoMCP/
├── src/
│   ├── rhino_plugin/       # Rhino插件代码
│   └── mcp_server/        # MCP服务器代码
├── requirements.txt      # 项目依赖项列表
└── README.md             # 项目文档

贡献

我们欢迎社区贡献！请参考CONTRIBUTING.md了解如何参与。

许可证

该项目受MIT License的保护。