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 никогда не обновляется сам. Установка другой версии всегда требует осознанного запуска другого установщика.

При запуске Rhino автоматически открывается локальная панель подключения в браузере Windows по умолчанию. Она работает без доступа к интернету и не требует отдельного приложения, службы или расширения браузера.

Related MCP server: Grasshopper MCP

Проверки соответствия архитектурным нормам

Rhino MCP включает компактный офлайн-поисковый индекс, построенный из предоставленной библиотеки нормативов Google Drive. Исходные файлы хранятся вне этого публичного репозитория; встроенный индекс хранит доступный для поиска текст страниц, метаданные источников и ссылки на оригиналы. Это фиксированный снимок, который никогда не синхронизируется и не обновляется сам. Снимок содержит 289 исходных файлов, 272 документа, доступных для поиска, и 7 896 проиндексированных страниц. Азербайджанский, русский и английский OCR восстановил 553 отсканированные PDF-страницы и 66 листов изображений/TIFF без ошибок извлечения.

Для запросов, связанных с архитектурой, строительством, доступностью, пожарной безопасностью, конструкциями, санитарными нормами, энергетикой, водоотведением, укрытиями, планировкой участка или смежными темами в Grasshopper, каждый MCP-клиент получает постоянно действующую рабочую инструкцию:

1. установить юрисдикцию, тип occupancy/проекта, стадию проектирования и ограничения;

2. искать в библиотеке нормативов перед предложением регулируемых размеров или изменением модели;

3. указывать точное название документа, идентификатор источника Drive и страницу для каждого требования;

4. отделять проверенные требования источников от рекомендаций и выводов; и

5. отмечать отсутствие доказательств, конфликты, неопределённую применимость и необходимость лицензированной локальной проверки.

Текст документов рассматривается как ненадёжные справочные данные, а не как исполняемые инструкции. ИИ не должен выдумывать значения кодов или описывать свою проверку как разрешение, одобрение или сертификат юридического соответствия.

Всегда доступные инструменты регулирования:

• regulation_library_status

• search_regulations

• get_regulation_page

• architecture_regulation_checklist

Поиск расширяет распространённые английские архитектурные термины на азербайджанский и русский, чтобы модель могла найти многоязычные исходные материалы. Проверьте установленный снимок или попробуйте поиск с:

rhino-mcp regulations status
rhino-mcp regulations search "fire evacuation stairs"

Коллекция источников и её действующий правовой статус не были независимо сертифицированы. Ответственный архитектор или инженер должен подтвердить юрисдикцию, применимость, поправки, конфликты и текущие требования до начала строительства.

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

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

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

Панель подключения

При каждом запуске Rhino Rhino MCP открывает одну вкладку панели в браузере Windows по умолчанию. Используется тот браузер, который выбрал пользователь; Chrome не обязателен. Страница показывает текущее состояние:

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

• Codex / Claude / Cursor — подключён, ожидает или не настроен

• Grasshopper — подключён или не открыт

• Regulations — загружены или не установлены

Страница обновляет статус раз в секунду. Если Rhino закрывается, существующая вкладка меняется на Rhino is offline и продолжает попытки; когда Rhino снова открывается, она подключается автоматически. Вкладку можно закрыть в любой момент. Выполните RhinoMCPDashboard в Rhino, чтобы открыть её снова.

Адрес по умолчанию — http://127.0.0.1:9877/. Он обслуживается напрямую плагином Rhino, привязывается только к этому компьютеру, доступен только для чтения, не загружает веб-ресурсы и ничего не отправляет в интернет. Если этот порт уже занят, Rhino MCP автоматически выбирает частный локальный запасной вариант и открывает правильный адрес.

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

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

Заголовок показывает CONNECTED — READY, WAITING FOR CODEX/CLAUDE/CURSOR, SETUP NEEDED или BRIDGE STOPPED. Четыре живых индикатора показывают:

• Bridge — зелёный, когда Rhino слушает

• Codex / Claude / Cursor — зелёный, когда выбранный AI-клиент подключён

• Grasshopper — зелёный, когда Grasshopper открыт и его мост доступен

• Rules — зелёный, когда офлайн-библиотека нормативов загружена

Полоса намеренно не включается в изображения видового экрана, возвращаемые ИИ. Выполните RhinoMCP, чтобы скрыть или показать её. Для устранения неполадок Rhino также предоставляет:

• RhinoMCPDashboard — повторно открыть панель в браузере

• RhinoMCPStatus — показать полосу и вывести полный статус, порты и URL панели

• RhinoMCPRestart — перезапустить локальный мост Rhino

• RhinoMCPTest — создать, проверить и автоматически удалить тестовый куб

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

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

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

Установки из исходников и 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 сообщает состояния pass/fail/wait для пакета, настроек, каждого AI-клиента, Rhino, Grasshopper и лаунчера сервера. Закрытые Rhino и Grasshopper отображаются как WAIT с точным следующим действием, а не как трассировки сокетов.

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

Basic (по умолчанию)

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

• 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-компонента для загрузки.

Developer

Явно добавляет произвольные Python-инструменты Rhino и Grasshopper. Они отсутствуют в схемах инструментов Basic и 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; только вызовы Rhino API маршалируются в него.

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

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

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
        ├── offline regulation search index
        │
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + visible viewport status strip
        ├── read-only browser dashboard at 127.0.0.1
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

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

Лицензия

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