revit-tunnel MCP (Dovelas independientes V2)

Este es un MCP especializado independiente del MCP genérico de Revit existente. Permite al Agente previsualizar, crear y verificar túneles de escudo mediante el MCP stdio de Node.js, la interfaz pyRevit Routes solo local y la API de Revit 2025. La versión anterior de "una familia completa por anillo" se conserva íntegramente; V2 añade "un componente de familia independiente por dovela".

Capacidad de dovelas independientes

• La disposición predeterminada es 9A1K: 9 dovelas A por anillo (37,5° cada una) y 1 dovela K (22,5°).

• Con 10 anillos predeterminados se crean 100 instancias de familia Generic Models que se pueden seleccionar, contar, filtrar y tabular individualmente.

• Admite de 1 a 50 anillos, pero cualquier creación individual admite como máximo 500 dovelas independientes.

• Admite diámetro exterior, espesor, ancho de anillo, punto de inicio tridimensional, pendiente longitudinal recta y alternancia de juntas escalonadas positivas y negativas entre anillos adyacentes.

• Cada anillo crea solo un plano de trabajo de referencia denominado RTM_SEG_HOST_*, compartido por todas las dovelas del mismo anillo.

• Cada dovela tiene una marca estable, por ejemplo batch-R0001-A01, batch-R0001-K01.

• La creación por lotes está envuelta en un grupo de transacciones de Revit; si falla cualquier familia o componente, las instancias, los planos de referencia y las familias recién cargadas en esta operación se revierten juntos.

Related MCP server: RevitMCPBridge2026

Contenido de familia actualizable

El nombre de la familia se determina conjuntamente por el rol del componente, las dimensiones, los ángulos, la configuración de contenido y la versión de contenido:

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

El proveedor de contenido actual es basic versión 1, que genera una familia simple de sector anular para cada geometría. El Type Comments del tipo de familia almacena RTM_CONTENT:<hash>. Las familias con el mismo nombre solo se reutilizan si el hash de contenido coincide exactamente; si falta el hash o difiere, se reporta un conflicto y no se sobrescribe silenciosamente.

Por lo tanto, en el futuro, al añadir a las dovelas orificios de inyección, orificios para pernos, nichos de mano, ranuras o representación de armadura, se puede publicar una nueva versión de contenido. Los lotes antiguos permanecen congelados en la versión de familia original; la disposición, la numeración de componentes y el flujo de llamadas del Agente no necesitan reescribirse.

Parámetros de identidad del componente

Todas las familias de dovelas independientes utilizan 12 parámetros compartidos de instancia con GUID fijos:

• RTM_BatchId, RTM_UniqueId

• RTM_RingIndex, RTM_SegmentIndex

• RTM_SegmentSlot, RTM_SegmentRole

• RTM_LayoutId

• RTM_ContentProfile, RTM_ContentVersion

• RTM_StartAngle, RTM_EndAngle, RTM_CenterAngle

Los GUID fijos permiten que las futuras familias A, B, K y las versiones de diferente precisión sigan utilizando el mismo conjunto de tablas de planificación, filtros y etiquetas.

Ocho herramientas MCP

Dovelas independientes V2:

• list_tunnel_segment_catalog: enumera las disposiciones y versiones de contenido.

• preview_tunnel_segments: validación de solo lectura y devuelve el plan completo dovela por dovela con un token de vista previa.

• create_tunnel_segments: requiere los mismos parámetros, preview_token y confirm=true para crear.

• inspect_tunnel_segment_batch: consulta inversa de solo lectura de la identidad, versión de familia, posición, orientación, volumen y plano de referencia portador de cada componente.

Anillos completos V1 conservados:

• preview_tunnel_rings

• create_tunnel_rings

• inspect_tunnel_batch

• get_tunnel_backend_status (compartido por V1/V2)

El orden de llamada recomendado es: verificar el backend → enumerar el catálogo → previsualizar → confirmación del usuario → crear → inspeccionar el lote.

Cambio posterior a 6A＋2B＋1K

La disposición y el contenido de la familia ya están en capas. En el futuro, al añadir 6A2B1K, solo es necesario agregar 9 posiciones y las reglas de ángulo para A/B/K en el catálogo versionado; el colocador, los parámetros de identidad, las herramientas MCP y la interfaz de inspección permanecen sin cambios. Si la geometría de B difiere de la de A, el sistema resolverá automáticamente la nueva especificación de familia según su rol y ángulo.

Límites de seguridad

• Routes solo escucha en 127.0.0.1:48884, sin exposición a la red local.

• La vista previa de Node y el backend de pyRevit validan el plan completo por separado; V2 además recalcula el resumen de disposición, las posiciones anillo por anillo, los ángulos dovela por dovela, las marcas, los nombres de familia y los hashes de contenido.

• Los anillos completos y las dovelas independientes comparten el espacio de nombres global de batch_id; si ya existe en cualquiera de los lados, se rechaza la creación duplicada.

• Actualmente no hay herramientas para eliminar, sobrescribir o actualizar lotes existentes.

• El MCP genérico de Revit existente y ShieldTunnel.extension no se han modificado.

Instalación

• Código fuente: el directorio del proyecto tras clonar este repositorio

• Extensión pyRevit: %USERPROFILE%\Documents\pyRevit Extensions\RevitTunnelMcp.extension

• Configuración de Codex: [mcp_servers.revit_tunnel] en %USERPROFILE%\.codex\config.toml

Instale primero Node.js 22 y las dependencias del proyecto:

npm install

Reinstale la extensión:

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

Tras instalar o modificar, es necesario recargar pyRevit (o reiniciar Revit).

Verificación y llamadas de prueba

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

Crear un lote de prueba de dos anillos de dovelas independientes:

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

Las llamadas de la versión anterior de anillos completos no incluyen --segments. --create modifica realmente el proyecto de Revit actual y solo debe usarse en copias de prueba o proyectos confirmados.