RhinoMCP

RhinoMCP 通过模型上下文协议 (MCP) 将 Rhino3D 连接到 Claude AI，使 Claude 能够直接与 Rhino3D 交互并控制它，从而实现 AI 辅助的 3D 建模、分析和设计工作流程。

项目概述

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

1. Rhino 插件: 一个在 Rhino 的 Python 编辑器中运行的 Socket 服务器，提供与 Rhino 功能的通信接口。
2. MCP 服务器: 模型上下文协议的实现，将 Claude AI 连接到 Rhino 插件，从而实现 AI 控制的操作。

特性

• 基于 Socket 的 Python 和 Rhino 之间的双向通信
• 用于 Claude AI 集成的模型上下文协议服务器
• 支持 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 Bridge 服务器

1. 打开 Rhino
2. 在命令行中输入 EditPythonScript 以打开 Rhino 的 Python 编辑器
3. 从 src/rhino_plugin/rhino_server.py 打开 Rhino 服务器脚本
4. 运行脚本（F5 或单击“运行”按钮）
5. 验证您是否在输出面板中看到“Rhino Bridge started!”

步骤 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 曲线，提示如下：

Create a NURBS curve in Rhino using points at (0,0,0), (5,10,0), (10,0,0), and (15,10,0).

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

开发

设置开发环境

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

# 创建并激活虚拟环境
uv venv .venv
source .venv/Scripts/activate  # 在 Windows 上使用 Git Bash

# 安装开发依赖项
uv pip install -e ".[dev]"

运行测试

pytest

代码风格

本项目使用 Ruff 进行 linting 和格式化：

ruff check .
ruff format .

项目结构

RhinoMCP/
├── src/
│   ├── rhino_plugin/  # 在 Rhino 中运行的代码
│   │   └── rhino_server.py
│   └── rhino_mcp/     # MCP 服务器实现
│       ├── rhino_client.py
│       └── mcp_server.py
├── tests/             # 测试模块
├── docs/              # 文档
├── config/            # 配置文件
├── ai/                # AI 文档和提示
├── setup.py           # 包安装
├── requirements.txt   # 包依赖
└── README.md          # 项目文档

许可证

MIT 许可证

贡献

欢迎贡献！请随时提交 Pull Request。