RhinoMCP: MCP-сервер для Rhino 3D

105 инструментов для AI-управляемого 3D-моделирования, анализа, диагностики и интеграции с Grasshopper через Model Context Protocol.

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/). Python-пакет на основе FastMCP. Взаимодействует с Claude через stdio и с Rhino через TCP.

Слушатель Rhino (rhino/listener.py). Python-скрипт, работающий внутри Rhino. Открывает 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. Перейдите в Tools > PythonScript > Run

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

Протокол

Команды представляют собой JSON-объекты, отправляемые по TCP (разделены переводами строк):

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

Ответы:

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

Потокобезопасность

Слушатель Rhino использует Rhino.RhinoApp.InvokeOnUiThread() на Rhino 8+ для обеспечения выполнения всех операций с геометрией в потоке пользовательского интерфейса. На Rhino 7 операции выполняются напрямую (что безопасно для одноклиентских подключений).

Лицензия

MIT. См. LICENSE.

Автор

Karthick Raja B G, портфолио · GitHub

Связанный проект: SPIDER, плагин Grasshopper для вычислительной геометрии и пространственного анализа.