Descubre cómo transformar tu entorno BIM integrando la inteligencia artificial directamente en tus modelos. Utilizando el protocolo MCP (Model Context Protocol), pyRevit y Cursor, podrás conversar con tu modelo, auditar parámetros, automatizar el modelado y crear scripts al vuelo sin salir del chat.
Esta guía te lleva paso a paso desde la instalación hasta la ejecución de tu primer prompt de IA interactuando en tiempo real con Revit. Está escrita para quien no está habituado a estas herramientas: cada paso explica qué hacer y por qué.
Requisitos previos
Antes de comenzar, asegúrate de tener esto listo:
Python instalado
Necesitas Python global en tu sistema. El protocolo MCP lo usa como servidor intermediario. Una vez instalado, abre tu terminal (CMD o PowerShell) e instala las librerías base:
pip install mcp httpx
Revit 2027
Versión 2027 instalada. Es vital que durante las pruebas no estés en la pantalla de inicio ("Home"): el servidor MCP necesita un documento o familia abierto.
Guía paso a paso
Descarga el instalador de pyRevit desde su repositorio oficial en GitHub. Al abrir Revit por primera vez tras la instalación, asegúrate de indicarle que siempre cargue este complemento.
Usa el instalador "Admin / All Users" para evitar problemas de permisos.
Ve a la pestaña pyRevit → Settings.
- En el panel izquierdo, busca Routes.
- Activa el interruptor Enable Routes Server (Beta).
- Marca la casilla pyrevit-core/.
- Haz clic en Save Settings and Reload para aplicar los cambios.
Ve a pyRevit → Extensions. Busca e instala la extensión llamada mcp-server-for-revit-python. Una vez instalada, recarga Revit o pyRevit de nuevo.
¡Crítico! Abre un proyecto o una familia en Revit. El servidor no funcionará si estás en la pantalla de inicio ("Home").
Abre tu navegador y visita:
http://localhost:48884/revit_mcp/status/
Si todo está correcto deberías ver una respuesta JSON como esta:
{
"status": "healthy",
"api_name": "revit_mcp",
"revit_available": true
}
Descarga Cursor desde su web oficial si aún no lo tienes. Dentro de Cursor, abre Settings → Features → MCP y haz clic en + Add New MCP Server. Configúralo como "command" con el siguiente JSON (cambia tu_usuario por tu usuario real de Windows):
{
"mcp-server-for-revit-python": {
"command": "python",
"args": [
"C:\\Users\\tu_usuario\\AppData\\Roaming\\pyRevit\\Extensions\\mcp-server-for-revit-python.extension\\main.py"
]
}
}
Verifica que aparezca el punto verde junto al nombre del servidor: indica que Cursor ha hecho el "handshake" correctamente con pyRevit.
Abre el chat de Cursor y envía este prompt para comprobar la conexión:
Prompt de ejemplo"Consulta el estado de Revit 2027 y dime el nombre del documento activo y su unidad de proyecto."
Verás cómo Cursor invoca automáticamente la herramienta get_revit_status, extrae la información de tu modelo y te la redacta en lenguaje natural.
Casos de uso y herramientas (tools)
El servidor MCP expone alrededor de 20 herramientas que la IA de Cursor puede usar de forma autónoma según lo que le pidas.
Auditoría y extracción de datos
Extrae información valiosa sin crear tablas de planificación temporales.
Prompt de ejemplo"Enumera todos los muros visibles en la vista actual, agrúpalos por tipo de familia y dime el valor del parámetro 'Volumen' total de cada grupo."
get_current_view_elementslist_category_parametersget_revit_model_info
Automatización de modelado
Delega la colocación repetitiva de elementos o la estructuración del proyecto.
Prompt de ejemplo"Busca la familia 'Mesa de Reuniones' en el modelo y coloca una en el Nivel 1, exactamente en las coordenadas X:10, Y:5, Z:0."
place_familylist_levelslist_families
Gestión gráfica y control de calidad
Aplica overrides de color al instante para resaltar errores o clasificar elementos.
Prompt de ejemplo"Pinta de color rojo brillante todos los elementos de la categoría 'Puertas' en esta vista para poder ubicarlos rápidamente. Cuando termine de revisarlo, límpialos."
color_splashclear_colorslist_revit_views
El comodín: código directo
Si no existe una herramienta predefinida, Cursor puede escribir y ejecutar un script de la API de Revit al vuelo.
Prompt de ejemplo"Escribe y ejecuta un script de Python en Revit que seleccione todos los muros del proyecto y copie el texto del parámetro 'Marca de Tipo' hacia el parámetro 'Comentarios'."
execute_revit_code