Rhino MCP

Низкопороговый мост между Rhino и Grasshopper для Codex, Claude и Cursor.

Работа в Windows намеренно проста:

1. Скачайте и запустите RhinoMCP-Windows-Setup.

2. Выберите Codex, Claude или Cursor.

3. Откройте Rhino, откройте Grasshopper и начните давать команды.

Ни Rhino Package Manager, ни клонирование репозитория, ни установка Python, ни uv, ни окружение Conda, ни Python-скрипт Rhino, ни файл Grasshopper, ни изменение Python-path, ни команда в терминале, ни ручная правка конфигурации MCP не являются частью обычной установки.

Установка

Требуется Rhino 8.0 или новее и выбранный вами AI-клиент. Rhino 8.1 поддерживается без обновления Rhino. Закройте Rhino, скачайте единственный файл RhinoMCP-Windows-Setup-*.exe из последнего релиза и дважды щёлкните по нему. Установщик запросит AI-клиента, а затем автоматически:

• устанавливает мосты Rhino и Grasshopper с помощью встроенного установщика Rhino;

• устанавливает автономный MCP-сервер со всем его окружением;

• безопасно записывает запись MCP для Codex, Claude или Cursor;

• выбирает безопасный профиль инструментов Grasshopper;

• запускает проверки doctor; и

• добавляет обычную запись в Установленные приложения Windows для чистого удаления.

Установщику не требуется, чтобы Rhino был в сети, он не загружает зависимости, и Rhino MCP никогда не обновляется сам. Установка другой версии всегда требует осознанного запуска другого установщика.

Для управляемого или тихого развёртывания тот же загружаемый файл поддерживает:

.\RhinoMCP-Windows-Setup-0.3.3.exe /CLIENT=codex /SILENT

Допустимые значения клиента: codex, claude и cursor. Перезапустите выбранный AI-клиент после установки. Пользователи Codex могут выполнить /mcp, чтобы убедиться, что rhino-mcp включён.

Related MCP server: Grasshopper MCP

Что появляется в Rhino

Панель Rhino MCP (можно закрепить) открывается автоматически при каждом запуске Rhino. Она остаётся видимой, пока пользователь её не скроет, остаётся скрытой до конца сеанса и снова появляется при следующем запуске Rhino. Выполните команду RhinoMCP в любой момент, чтобы показать или скрыть её вручную.

Панель вписывается в обычную полосу панелей/заголовков Rhino. В её заголовке отображается Подключено — готово к командам Rhino, Rhino MCP работает — ожидание AI-клиента или действующее сообщение об остановке/отсутствии настройки. Также на ней показаны:

• MCP-сервер подключён или ожидает

• мост Rhino подключён или остановлен

• Grasshopper доступен или не запущен

• выбранный AI-клиент и профиль инструментов

• порты Rhino и Grasshopper

• последние журналы

• кнопки Перезапустить, Создать тестовый куб и Скопировать команду doctor

Установщик включает обе сборки среды выполнения Rhino 8. Rhino автоматически использует net7.0 в обычной среде выполнения или net48, если Rhino настроен на устаревшую среду выполнения .NET Framework; пользователю не нужно выбирать или настраивать это.

Проверка соединения создаёт куб размером в одну единицу, проверяет его и удаляет. Если очистка отключена, тестовый куб остаётся в документе.

Расширенные команды

Кнопка Скопировать команду doctor на панели Rhino копирует правильный полный путь для пользователей установщика. Установки из исходников и Python-пакетов могут использовать:

rhino-mcp setup [codex|claude|cursor]
rhino-mcp doctor [--json]
rhino-mcp status [--json]
rhino-mcp update
rhino-mcp uninstall [--all]
rhino-mcp config [codex|claude|cursor]
rhino-mcp config --profile basic|grasshopper|developer

doctor сообщает о состояниях «пройдено»/«не пройдено»/«ожидание» для пакета, настроек, каждого AI-клиента, Rhino, Grasshopper и лаунчера сервера. Закрытые Rhino и Grasshopper отображаются как WAIT с точным следующим действием, а не как трассировки сокетов.

Профили инструментов

Базовый (по умолчанию)

Безопасный повседневный набор:

• rhino_status

• get_scene_summary

• list_layers

• list_objects

• get_scene_changes

• create_geometry

• modify_objects

• delete_objects

• organize_layers

• batch_geometry

• test_connection

• capture_viewport

Grasshopper

Добавляет постраничный контекст определения, проверку выбранных/объектов и инструменты пересчёта. Встроенный .gha автоматически запускает свой мост при открытии Grasshopper; нет ни определения .gh, ни Python-компонента для загрузки.

Разработчик

Явно добавляет произвольные Python-инструменты Rhino и Grasshopper. Они отсутствуют в схемах инструментов «Базовый» и «Grasshopper», поэтому AI-клиент не может случайно их обнаружить или вызвать. Безопасные высокоуровневые операции по-прежнему предпочтительны.

Безопасное поведение при редактировании

• Каждый изменяющий запрос получает именованную запись отмены Rhino.

• Пакет выполняет все операции в одной транзакции и перерисовывает один раз.

• Инструменты геометрии и слоёв принимают dry_run: true для проверки и предпросмотра.

• Для удаления требуются явные идентификаторы объектов Rhino.

• Результаты чтения — структурированные объекты, а не JSON, закодированный в строках.

• Списки объектов и Grasshopper фильтруются и разбиваются на страницы.

• get_scene_changes отправляет только добавления, изменения и удаления с момента указанной версии сцены.

Пример запроса:

Create a 10 × 8 × 3 box on a layer named Massing. Dry-run it first, then create it
and show me a compressed viewport capture.

Надёжность и производительность

• Сообщения с 4-байтовым префиксом длины заменяют старый огромный буфер приёма.

• Запросы читаются ограниченными фрагментами по 64 КиБ с жёстким лимитом 64 МиБ.

• TCP-соединения Rhino и HTTP-соединения Grasshopper поддерживаются живыми и переиспользуются.

• Неудачное безопасное чтение автоматически переподключается один раз.

• Мутации никогда не повторяются вслепую, что предотвращает дублирование геометрии.

• Недолговечные метаданные сцены кэшируются и аннулируются после изменений.

• Изменения сцены и большие документы разбиваются на страницы, а не возвращаются целиком повторно.

• Контекст Grasshopper по умолчанию упрощён.

• Захват видов по умолчанию использует сжатый JPEG с настраиваемым размером и качеством.

• Работа с сокетами и кодирование изображений выполняются вне UI-потока Rhino; только вызовы API Rhino маршалируются в него.

• Описания инструментов и обычные ответы намеренно компактны для снижения расхода токенов модели.

Измените настройки изображений по умолчанию с помощью:

rhino-mcp config --image-size 1280 --image-quality 82

Сборка для разработчика

Python-пакет:

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q
python -m build

Плагин Rhino 8 и архив Package Manager:

./scripts/build-yak.sh Release

Скрипт собирает RhinoMCP.rhp, RhinoMCP.Grasshopper.gha и .yak в каталоге dist/.

Полный установщик Windows (запускается в PowerShell на Windows):

python -m pip install -e ".[dev]" "pyinstaller==6.22.2"
choco install innosetup --yes
.\scripts\build-windows-installer.ps1

CI компилирует и проводит смоук-тесты встроенного исполняемого файла Windows и однофайлового установщика. Тегированные релизы прикрепляют установщик, его SHA-256 контрольную сумму и ручные артефакты для разработчиков.

Архитектура

Codex / Claude / Cursor
        │ MCP stdio
        ▼
bundled rhino-mcp.exe
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + dockable panel
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

Оба моста привязываются только к 127.0.0.1; они не доступны из сети.

Лицензия

MIT. Этот репозиторий автономен и не имеет вышестоящего Git-удалённого репозитория.