Scan to contactarticle
README
🚀 RhinoMCP
RhinoMCP通过模型上下文协议（MCP）将Rhino3D与Claude AI连接起来，使Claude能够直接与Rhino3D进行交互和控制，从而实现AI辅助的三维建模、分析和设计工作流程。
🚀 快速开始
RhinoMCP将Rhino3D与Claude AI集成，实现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桥接服务器
- 打开Rhino。
- 在命令行中输入
EditPythonScript以打开Rhino的Python编辑器。 - 从
src/rhino_plugin/rhino_server.py打开Rhino服务器脚本。 - 运行脚本（F5或单击“运行”按钮）。
- 确认在输出面板中看到“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曲线。
📚 详细文档
项目概述
此集成包含两个主要组件：
- Rhino插件：在Rhino的Python编辑器内部运行的套接字服务器，提供与Rhino功能之间的通信接口。
- MCP服务器：实现模型上下文协议（MCP）的服务器，将Claude AI连接到Rhino插件，从而实现AI控制的操作。
开发
设置开发环境
# 克隆仓库
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的保护。