🚀 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桥接服务器

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曲线。

📚 详细文档

项目概述

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

1. Rhino插件：在Rhino的Python编辑器内部运行的套接字服务器，提供与Rhino功能之间的通信接口。
2. 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的保护。