revit-tunnel MCP（独立管片 V2）

Это специализированный MCP, независимый от существующего универсального Revit MCP. Он позволяет агенту предварительно просматривать, создавать и проверять щитовые тоннели через Node.js stdio MCP, локальный интерфейс pyRevit Routes и API Revit 2025. Старая версия «одно цельное семейство на кольцо» полностью сохранена; V2 добавляет «одно независимое семейство на сегмент».

Возможности независимых сегментов

• Макет по умолчанию — 9A1K: 9 сегментов A (по 37,5°) и 1 сегмент K (22,5°) на кольцо.

• По умолчанию 10 колец создают 100 экземпляров семейств Generic Models, которые можно выбирать, подсчитывать, фильтровать и включать в спецификации по отдельности.

• Поддерживается 1–50 колец, но за один раз создаётся не более 500 независимых сегментов.

• Поддерживаются наружный диаметр, толщина, ширина кольца, трёхмерная начальная точка, прямолинейный продольный уклон, а также чередующееся положительное/отрицательное смещение швов между соседними кольцами.

• Для каждого кольца создаётся только одна рабочая плоскость с именем RTM_SEG_HOST_*, общая для всех сегментов этого кольца.

• Каждый сегмент имеет стабильную маркировку, например batch-R0001-A01, batch-R0001-K01.

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

Related MCP server: RevitMCPBridge2026

Обновляемое содержимое семейств

Имя семейства определяется ролью элемента, размерами, углами, конфигурацией содержимого и версией содержимого:

RTM_Segment_{role}_OD{outer}_T{thickness}_W{width}_S{spanMilliDeg}_{profile}_V{version}

Текущий поставщик содержимого — basic версии 1, который генерирует простое кольцевое секторное семейство для каждой геометрии. В Type Comments типа семейства сохраняется RTM_CONTENT:<hash>. Семейство с тем же именем повторно используется только при полном совпадении хеша содержимого; при отсутствии хеша или его несовпадении сообщается о конфликте, без тихого перезаписывания.

Таким образом, в будущем при добавлении к сегментам тампонажных отверстий, болтовых отверстий, лючков, пазов или арматурного отображения можно публиковать новые версии содержимого. Старые партии остаются замороженными на исходной версии семейства; макет, нумерация элементов и процесс вызова агента не требуют переработки.

Параметры идентификации элементов

Все независимые сегментные семейства используют 12 общих параметров экземпляра с фиксированными GUID:

• RTM_BatchId, RTM_UniqueId

• RTM_RingIndex, RTM_SegmentIndex

• RTM_SegmentSlot, RTM_SegmentRole

• RTM_LayoutId

• RTM_ContentProfile, RTM_ContentVersion

• RTM_StartAngle, RTM_EndAngle, RTM_CenterAngle

Фиксированные GUID гарантируют, что будущие семейства A, B, K и версии с разной точностью по-прежнему смогут использовать один и тот же набор спецификаций, фильтров и меток.

Восемь инструментов MCP

Независимые сегменты V2:

• list_tunnel_segment_catalog: выводит список макетов и версий содержимого.

• preview_tunnel_segments: проверка только для чтения с возвратом полного пошагового плана и токена предварительного просмотра.

• create_tunnel_segments: создание при совпадении параметров, preview_token и confirm=true.

• inspect_tunnel_segment_batch: обратный запрос только для чтения по каждому элементу: идентичность, версия семейства, положение, ориентация, объём и несущая рабочая плоскость.

Сохранённые цельные кольца V1:

• preview_tunnel_rings

• create_tunnel_rings

• inspect_tunnel_batch

• get_tunnel_backend_status (общий для V1/V2)

Рекомендуемый порядок вызова: проверить бэкенд → вывести каталог → предварительный просмотр → подтверждение пользователя → создание → проверка партии.

Последующее переключение на 6A＋2B＋1K

Макет и содержимое семейств уже разделены на уровни. В будущем при добавлении 6A2B1K потребуется лишь добавить 9 слотов и угловые правила для A/B/K в версионированный каталог; разместитель, параметры идентичности, инструменты MCP и интерфейс проверки остаются без изменений. Если геометрия B отличается от A, система автоматически разрешит новую спецификацию семейства по роли и углу.

Границы безопасности

• Routes прослушивает только 127.0.0.1:48884 и не открывается в локальную сеть.

• Предварительный просмотр Node и бэкенд pyRevit независимо проверяют полный план; V2 дополнительно пересчитывает сводку макета, положение каждого кольца, углы каждого сегмента, маркировку, имена семейств и хеши содержимого.

• Цельные кольца и независимые сегменты используют общее пространство имён batch_id; если идентификатор уже существует на любой стороне, повторное создание отклоняется.

• В настоящее время нет инструментов для удаления, перезаписи или обновления существующих партий.

• Существующий универсальный Revit MCP и ShieldTunnel.extension не изменяются.

Установка

• Исходный код: каталог проекта после клонирования этого репозитория

• Расширение pyRevit: %USERPROFILE%\Documents\pyRevit Extensions\RevitTunnelMcp.extension

• Конфигурация Codex: [mcp_servers.revit_tunnel] в %USERPROFILE%\.codex\config.toml

Сначала установите Node.js 22 и зависимости проекта:

npm install

Переустановите расширение:

& '.\scripts\install.ps1' -RoutesPort 48884

После установки или изменения необходимо перезагрузить pyRevit (или перезапустить Revit).

Проверка и дымовые вызовы

npm test
python -m pytest -q '.\pyrevit\tests'
node '.\scripts\smoke-test.mjs' --segments --inspect --batch-id=<批次>

Создание тестовой партии из двух колец независимых сегментов:

node '.\scripts\smoke-test.mjs' --segments --create --ring-count=2 --batch-id=segment-e2e-01

Старые вызовы цельных колец не используют --segments. --create реально изменяет текущий проект Revit и должен использоваться только на тестовой копии или в подтверждённом проекте.