RhinoMCP：一个用于 Rhino 3D 的 MCP 服务器

105 个工具，用于通过 Model Context Protocol 进行 AI 驱动的 3D 建模、分析、诊断和 Grasshopper 集成。

RhinoMCP 通过一套全面的工具将 Claude 连接到 Rhino 3D，涵盖从基本图元到高级曲面建模（放样、扫掠、旋转）、布尔运算、网格诊断、块管理和 Grasshopper 参数化设计等所有内容。

架构

┌────────────────┐   stdio    ┌──────────────┐   TCP/JSON    ┌──────────────┐
│ Claude Desktop │◄──────────►│  rhino_mcp   │◄─────────────►│    Rhino 3D  │
│                │   (MCP)    │  (Python)    │  localhost:   │  listener.py │
│                │            │  server.py   │    9876       │  (inside     │
└────────────────┘            └──────────────┘               │   Rhino)     │
                                                             └──────────────┘

MCP 服务器（rhino_mcp/）。使用 FastMCP 的 Python 包。通过 stdio 与 Claude 通信，通过 TCP 与 Rhino 通信。

Rhino 监听器（rhino/listener.py）。在 Rhino 内部运行的 Python 脚本。打开 TCP 服务器，接收 JSON 命令，使用 RhinoCommon/rhinoscriptsyntax 执行这些命令，并返回结果。

Related MCP server: Grasshopper MCP

功能

几何创建（21 个工具）

变换（8 个工具）

move、rotate、scale、scale_non_uniform、mirror、copy、array_linear、array_polar

布尔运算（3 个工具）

boolean_union、boolean_difference、boolean_intersection

修改（18 个工具）

块和实例（4 个工具）

create_block、insert_block、list_blocks、explode_block

用户数据（2 个工具）

set_user_text、get_user_text：存储元数据、BIM 数据、成本等。

图层（6 个工具）

list_layers、create_layer、delete_layer、set_layer_color、set_layer_visibility、set_current_layer

材质（3 个工具）

list_materials、create_material、assign_material

分析（10 个工具）

诊断（4 个工具）

视图（5 个工具）

zoom_extents、set_view、capture_view（带 base64 选项）、list_views、set_display_mode

Grasshopper（3 个工具）

gh_run_script、gh_set_slider、gh_get_outputs

代码执行（2 个工具）

run_python、run_command：完全访问 rhinoscriptsyntax 和 RhinoCommon

撤销/重做（2 个工具）

undo、redo

场景（4 个工具）

scene_info、get_objects、get_object（包含边缘信息的详细）、select_objects

导入/导出（2 个工具）

export（.3dm、.obj、.stl、.step、.iges、.fbx）、import_file

粗体 = v2.0 新增

先决条件

• Rhino 7 或 8（Windows 或 Mac）

• Python 3.10+

• uv 包管理器（安装）

安装

1. 克隆并安装

git clone https://github.com/kbangaru-cyber/rhino-mcp.git
cd Rhino_MCP
uv sync

2. 启动 Rhino 监听器

在 Rhino 中：

1. 转到 工具 > PythonScript > 运行

2. 选择 rhino/listener.py

3. 你应该看到：

============================================================
  RhinoMCP Listener v2.0.0
  Listening on 127.0.0.1:9876
  Registered handlers: 90
  Ready for MCP connection (Claude)
============================================================

3. 配置 Claude Desktop

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "rhino": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/Rhino_MCP", "run", "rhino-mcp"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1",
        "RHINO_MCP_PORT": "9876",
        "RHINO_MCP_TIMEOUT": "30"
      }
    }
  }
}

使用示例

创建简单的建筑形体

“为建筑体量创建一个 10x8x4 米的盒子，然后在中心添加一个半径为 2、高度为 6 的圆柱体作为塔楼。将它们并集，并对所有边缘进行半径为 0.3 的圆角。”

诊断模型问题

“检查场景中的所有对象是否有问题。查找任何裸露边缘，并告诉我需要修复什么。”

参数化设计

“通过创建轮廓曲线并旋转来制作花瓶形状。然后在它周围创建装饰性圆柱体的极轴阵列。”

内置提示

RhinoMCP 包含引导式工作流提示：

• model-from-description：从文本描述创建 3D 模型的结构化工作流

• diagnose-model：查找和修复模型问题的系统方法

• parametric-design：Grasshopper/参数化工作流指南

资源

服务器将实时数据作为 MCP 资源公开：

配置

开发

# Install dev dependencies
uv sync --extra dev

# Run tests (no Rhino needed)
uv run pytest -v

# Lint
uv run ruff check .

# Type check
uv run mypy rhino_mcp

集成测试

在 Rhino 运行且监听器激活的情况下：

uv run pytest -v -m integration

协议

命令是通过 TCP 发送的 JSON 对象（以换行符分隔）：

{"id": "abc123", "action": "create_sphere", "params": {"center": [0,0,0], "radius": 5}}

响应：

{"id": "abc123", "ok": true, "result": {"guid": "d3e4f5..."}}

线程安全

Rhino 监听器在 Rhino 8+ 上使用 Rhino.RhinoApp.InvokeOnUiThread() 以确保所有几何操作都在 UI 线程上运行。在 Rhino 7 上，操作直接执行（这对于单客户端连接是安全的）。

许可证

MIT。参见 LICENSE。

作者

Karthick Raja B G，作品集 · GitHub

相关工作：SPIDER，一个用于计算几何和空间分析的 Grasshopper 插件。