Revit Model MCP

Trabaja con modelos de Autodesk Revit en vivo desde cualquier cliente MCP, localmente o en un PC Windows remoto vía SSH: consulta, agrega, inspecciona y actúa con deshacer.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Revit Model MCP mark

Revit Model MCP

Para personas que revisan o automatizan proyectos de Revit con un cliente MCP: lea y actúe sobre un proyecto de Revit en vivo a través de MCP. Las acciones están habilitadas por defecto, y cualquier configuración de solo lectura las desactiva.

CI CodeQL OpenSSF Scorecard Latest release PyPI Downloads Revit 2022-2027 Python 3.11+ MIT

Política de privacidad

Revit Model MCP devuelve los datos del modelo solicitados al cliente MCP seleccionado. El paquete habilita la redacción de rutas de respuesta por defecto. La política de privacidad cubre la recopilación, almacenamiento, intercambio, retención e información de contacto.

Firma de código

Las compilaciones de lanzamiento aún no están firmadas con código, por lo que Revit pregunta si desea cargar el complemento después de la instalación y después de cada actualización. Verifique las descargas con SHA256SUMS.txt y la atestación de procedencia de la compilación; consulte firma de código.

Instalación

Paquete de Claude Desktop

Instale uv en el PATH del cliente, descargue revit-model-mcp-<version>.mcpb desde la última versión y ábralo en Claude Desktop. El paquete se inicia desde la caché local de uv. El servidor busca una versión estable más reciente en segundo plano una vez al día. El siguiente inicio del cliente utiliza la versión actualizada. Establezca REVIT_MCP_NO_UPDATE_CHECK=1 para optar por no participar. El formulario de configuración configura el host de la estación de trabajo, la redacción de rutas, las acciones opcionales y el token de portador HTTP sin editar JSON. Use local en la estación de trabajo Windows de Revit, o configure una estación de trabajo remota para clientes macOS y Linux. La redacción de rutas comienza habilitada y las acciones comienzan deshabilitadas. La estación de trabajo Windows aún necesita el complemento a continuación. Consulte la guía del paquete para detalles de compilación y requisitos previos.

Verifique las descargas. Los activos de lanzamiento incluyen atestaciones de procedencia de compilación de GitHub; siga verificación de descargas antes de instalar.

En la estación de trabajo de Revit

Descargue RevitModelMcp-<version>-SingleUser.msi (usuario actual) o RevitModelMcp-<version>-MultiUser.msi (todos los usuarios) desde la última versión. Ejecútelo con Revit cerrado, luego inicie Revit y abra un modelo. Consulte actualizaciones automáticas para el comportamiento de actualización y las configuraciones de exclusión. Alternativamente, ejecute desde un clon en PowerShell:

.\install.ps1 -Source Release

En la máquina con el cliente MCP

Instale uv y use Python 3.11+. Para Claude Code en la misma estación de trabajo Windows:

claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp

Para registro manual en Claude Desktop, agregue a su configuración MCP:

{
  "mcpServers": {
    "revit-model-mcp": {
      "command": "uvx",
      "args": ["revit-model-mcp"],
      "env": {
        "REVIT_MCP_HOST": "local",
        "REVIT_MCP_REDACT_PATHS": "1"
      }
    }
  }
}

Desde un clon, uv run --directory server revit-model-mcp ejecuta el mismo servidor sin instalar el paquete. Con REVIT_MCP_HOST=local el servidor llega a cada Revit a través de su propia tubería con nombre, restringida al usuario de Windows que ejecuta Revit; no se necesita reserva de puerto ni URL. Para clientes macOS o Linux, configure una estación de trabajo remota.

Verificación

Llame a revit_ping en el cliente MCP y espere success: true.

En acción

Claude Desktop se ejecuta en una Mac y se conecta a Revit 2026 en una estación de trabajo Windows. Las acciones están habilitadas en esta grabación.

Claude Desktop conversation on the left, Revit 2026 on the right: Claude reads the open model, finds the largest room, opens its plan and selects it, isolates it, places a chair and moves it, then cleans up

Si Revit Model MCP le ahorra tiempo, una :star: en GitHub ayuda a otros usuarios de Revit a encontrarlo.

Qué sucede en la grabación, en orden:

  1. "¿Qué modelo está abierto en Revit ahora mismo?" El cliente lee el documento, los niveles y los recuentos de habitaciones.
  2. "¿Qué nivel tiene la mayor área de habitaciones? Encuentre la habitación más grande y muéstremela." El cliente agrega áreas de habitaciones por nivel y consulta la habitación más grande. revit_show abre un plano correspondiente y selecciona la habitación.
  3. "Aísle esa habitación, coloque una silla Breuer en su centro y muévala 800 mm a lo largo de X." revit_isolate, luego revit_place_family en el roomCenterMm de la habitación, luego revit_move. Cada mutación es su propia transacción de Revit.
  4. La limpieza posterior es una frase más: restablezca la vista, elimine la silla.

La imagen a continuación es el PNG guardado por revit_export_view durante una sesión anterior contra Revit 2023 a través de SSH, sin modificar:

View exported by revit_export_view from the Revit sample project

Lo que obtiene

Herramientas de lecturaNombres
Documento y catálogorevit_ping, revit_document_info, revit_list_catalog, revit_list_instances
Elementos y parámetrosrevit_query_elements, revit_aggregate_elements, revit_element_details, revit_list_relations, revit_list_warnings
Vistas y exportaciónrevit_list_views, revit_view_summary, revit_view_elements, revit_view_warnings, revit_export_view
Verificaciones de coordinaciónrevit_model_health, revit_links_status, revit_shared_coordinates, revit_parameter_fill_check

Consulte la referencia completa de herramientas para argumentos, unidades y límites.

Las acciones están habilitadas por defecto: opte por no participar con REVIT_MCP_READ_ONLY=1 en el servidor, o el archivo read-only de la estación de trabajo. Las mutaciones del modelo admiten vistas previas de dry_run y devuelven verification y un summary legible por humanos; una acción confirmada se asimila en una entrada de deshacer de Revit con nombre, visible en el panel "Actividad MCP" del complemento; revit_undo_last la deshace mientras sigue siendo el último cambio de Revit. Consulte acciones para puertas, excepciones y fallos de verificación.

Estaciones de trabajo remotas

Los clientes Windows locales usan REVIT_MCP_HOST=local bajo la cuenta del usuario de Revit. Los clientes remotos ejecutan todo el servidor en la estación de trabajo a través de SSH, como el mismo usuario de Windows que ejecuta Revit. Instálelo allí una vez con uv tool install revit-model-mcp, luego registre ssh como el comando:

{
  "mcpServers": {
    "revit-model-mcp": {
      "command": "ssh",
      "args": ["revit-pc", "revit-model-mcp", "--redact-paths"]
    }
  }
}

Reemplace revit-pc con el alias de host SSH de la estación de trabajo. El flujo MCP stdio pasa a través de la sesión SSH y el servidor remoto usa la tubería con nombre, por lo que no se abre ningún puerto. REVIT_MCP_HOST=ssh:<alias> (canal de archivos a través de SSH) y HTTP a través de un túnel SSH siguen disponibles; HTTP requiere un token de portador excepto para /health y se vincula a loopback por defecto. Consulte configuración de transporte.

Seguridad

Las herramientas predeterminadas leen el modelo sin transacciones que modifiquen el modelo; las exportaciones y las operaciones de canal escriben archivos fuera de él. Las acciones MCP se rechazan en modo de solo lectura, mientras que los llamadores HTTP directos requieren el token de portador y se rechazan mientras el archivo de solo lectura de la estación de trabajo esté presente. REVIT_MCP_REDACT_PATHS=1 oculta directorios en los campos de ruta de respuesta, pero los nombres, valores de parámetros, errores, archivos de canal y valores de localPath de imágenes exportadas permanecen visibles. Consulte detalles de seguridad para autenticación y límites de privacidad, y SECURITY.md para informar una vulnerabilidad.

Compatibilidad

Año de RevitMarco de destino del complementoEstado de validación
2022.NET Framework 4.8Evidencia de compilación
2023.NET Framework 4.8Evidencia de compilación
2024.NET Framework 4.8Compilaciones y script de instalación
2025.NET 8Evidencia de compilación
2026.NET 8Compilaciones, lecturas/acciones en vivo y script de instalación
2027.NET 10Evidencia de compilación

Consulte evidencia de validación para fechas y límites, y brechas conocidas.

Contribución y soporte

Documentación cubre configuración, herramientas y transporte.

Comience con CONTRIBUTING.md, haga preguntas en Discusiones, o reporte errores y solicite funciones a través de los formularios de problemas. CI ejecuta los conjuntos de pruebas de C# y Python y compila las configuraciones de Revit compatibles.

Contribuyentes

Contributors

Licencia

MIT, mantenido por Dinar Sharafutdinov. Consulte avisos de terceros para licencias de dependencias.