Tekla MCP Server conecta clientes compatibles MCP con Tekla Structures para automatizar tareas de modelado, selección, vistas, propiedades, componentes, operaciones y planos. El repositorio teknovizier/tekla_mcp_server describe un servidor Python basado en FastMCP, con descubrimiento de recursos de proyecto y un modo de solo lectura. En la verificación GitHub del 26 de agosto de 2026, el repositorio tenía licencia GPLv3, 46 estrellas y 18 forks, y su documentación indicaba pruebas en Tekla 2022 y Tekla 2026.
Para un estudio de arquitectura, Tekla MCP no sustituye a un conector BIM generalista como Revit MCP. Se dirige sobre todo a equipos de estructura, hormigón prefabricado, acero, ejecución y planos de fabricación que ya trabajan en Tekla Structures. Su valor viene menos de una demostración de IA que de su capacidad para leer, seleccionar, filtrar, modificar y controlar objetos métier muy precisos.
Sumario
- Qué hace Tekla MCP Server
- Instalación y arquitectura
- Capacidades métier
- Comparación con MCP BIM y CAD
- Seguridad, solo lectura y límites
- Posición de Educasium
- Fuentes y siguiente lectura
Qué hace Tekla MCP Server
Idea clave: Tekla MCP Server expone Tekla Structures como un entorno consultable y controlable por un asistente de IA. Su documentación distingue herramientas de solo lectura, herramientas creativas que añaden objetos y herramientas destructivas que modifican o borran datos existentes.
Familias de herramientas
La referencia oficial clasifica las herramientas en selección, componentes, propiedades, vistas, operaciones, dibujos y modelado. La selección permite elegir elementos por filtro, nombre de filtro, GUID, ensamblaje o pieza principal. Las propiedades permiten leer objetos, coordenadas, cajas envolventes, diferencias entre elementos, cortes y UDAs. Las vistas cubren etiquetas temporales, zoom, redibujado, aislamiento visual, ocultación, coloración y aplicación de filtros de vista.
Componentes y modelado son más sensibles. El servidor puede insertar componentes, modificar o borrar componentes existentes, colocar vigas, columnas, paneles, losas y rejillas, mover, copiar o borrar elementos. Las operaciones también cubren acciones como cortes booleanos, vinculación de ensamblajes o armaduras, macros, clash check y creación de informes Tekla.
Planos y control de calidad
La parte de dibujos es especialmente rica. La referencia verificada lista lectura y modificación de propiedades de planos, emisión o anulación de emisión, actualización de planos, impresión PDF, exportación DWG, DXF o DGN, apertura y cierre de planos, lectura de vistas, lectura de anotaciones, búsqueda de objetos sin marca, movimiento de vistas y alineación de secciones. También incluye controles de colisiones de dibujo y cotas no asociadas.
Para un equipo de estructura, esto puede ser más importante que generar una viga. Los planos, marcas, vistas, colisiones de anotaciones y exportaciones son fuentes frecuentes de trabajo repetitivo. Un asistente que puede inspeccionar estos elementos bajo control puede ayudar a preparar una revisión, pero no debe decidir solo emitir o modificar planos de producción.
Instalación y arquitectura
Idea clave: Tekla MCP Server es un proyecto Python 3.11+ que exige Tekla Structures y una configuración local precisa. No se instala como una extensión simple de un clic.
Prerrequisitos y dependencias
El quickstart pide Python 3.11 o superior y recomienda uv pip install -r requirements.txt. El pyproject verificado indica el nombre tekla-mcp-server, la versión 0.2.3 y requires-python >=3.11. El archivo requirements.txt lista fastmcp 3.4.5, pathvalidate, pydantic, pythonnet, python-dotenv, sentence-transformers y ezdxf.
pythonnet señala que el servidor habla con el ecosistema .NET de Tekla. sentence-transformers sirve para la comprensión semántica de atributos. ezdxf se usa en flujos de dibujo, especialmente para analizar exportaciones. Estas dependencias explican por qué una prueba debe confiarse a una persona capaz de diagnosticar Python, rutas Windows, bibliotecas Tekla y configuración MCP.
Archivos de configuración
El quickstart pide copiar varios archivos de ejemplo: settings.json, element_types.json, semantic_overrides.json, base_components.json y report_properties.json. settings.json contiene la ruta de Tekla, la carpeta de contexto, read_only, excluded_tags, los parámetros de embeddings, las tolerancias y los ajustes de informes o dibujos. El servidor lee estos archivos al arrancar, así que cualquier modificación requiere reinicio.
Las variables de entorno TEKLA_MCP_LOG_LEVEL, TEKLA_MCP_LOG_FILE_PATH y TEKLA_MCP_CONFIG_DIR permiten fijar nivel de log, archivo de log y directorio de configuración. La documentación insiste en rutas absolutas para las variables de ruta. En la práctica, esta arquitectura favorece un puesto piloto documentado en lugar de una instalación improvisada en varias máquinas.
Capacidades métier
Idea clave: Tekla MCP Server está construido para workflows de estructura y ejecución, no solo para dibujar formas. Sus recursos descubren filtros, componentes, catálogos, fases, rejillas, informes, macros y archivos de contexto.
Recursos descubiertos
Los recursos MCP incluyen project://context, tekla://components, tekla://catalog/materials, tekla://catalog/rebars, tekla://macros, tekla://reports, tekla://element_types, tekla://filters/selection, tekla://filters/view, tekla://phases, tekla://grids y tekla://connection_status. Esto da al asistente más que comandos. Puede conocer nombres de filtros, materiales disponibles, perfiles de armaduras, fases y convenciones de proyecto si están descritas en la carpeta de contexto.
Esta lógica importa en producción real. Un asistente que ignora estándares de numeración, clases Tekla o nombres de filtros locales produce rápidamente resultados poco utilizables. Los recursos de proyecto ayudan a acercar el lenguaje natural a las convenciones del equipo.
Componentes y atributos semánticos
El README menciona un sistema de handlers para componentes, con el ejemplo de lifting anchors que seleccionan anclajes según el peso del elemento y calculan su colocación según el centro de gravedad. La configuración también describe base_components.json y propiedades personalizadas expuestas mediante tekla://components. El servidor puede adaptarse, por tanto, a componentes recurrentes.
La documentación de configuración describe un mapping semántico de atributos con un modelo MiniLM publicado en HuggingFace, teknovizier/minilm-tekla-attr-embed-v1, y un fallback LLM si la puntuación es incierta. Es útil cuando el usuario usa una expresión métier en vez del nombre exacto del atributo Tekla. La prudencia sigue siendo necesaria: todo mapping semántico debe probarse en un conjunto de componentes conocido antes de autorizarlo en un proyecto.
Comparación con MCP BIM y CAD
Idea clave: Tekla MCP Server es el conector más orientado a estructura y planos de fabricación en esta serie. Complementa los MCP BIM de arquitectura en lugar de sustituirlos.
| Opción | Uso natural | Fuerza principal | Límite a vigilar |
|---|---|---|---|
| Tekla MCP Server | Estructura, acero, prefabricado, planos y componentes | Herramientas métier, recursos de proyecto, modo solo lectura | Configuración pesada, acciones destructivas, GPLv3 |
| Revit MCP | Modelo BIM general de edificio | Objetos arquitectónicos, niveles, recintos y extracciones | Gobernanza BIM y dependencia del fork Revit |
| Civil 3D MCP | Urbanización, topografía, superficies y trazados | C# Roslyn dentro de Civil 3D, bibliotecas de skills | Ejecución de código y perímetro infraestructura |
| CAD-MCP | Dibujo DWG vía AutoCAD, GstarCAD o ZWCAD | COM Windows multi-CAD | Menos rico en objetos métier de estructura |
Diferencia con Revit MCP
Revit MCP actúa sobre una maqueta de edificio más generalista: muros, suelos, puertas, habitaciones, ejes, niveles y tablas. Tekla MCP Server baja más a objetos de estructura, componentes, UDAs, ensamblajes, armaduras y dibujos. La diferencia es por tanto menos una cuestión de tecnología IA que una cuestión de métier.
Para Educasium, esta página debe ser útil a arquitectos que colaboran con oficinas de estructura y constructoras. Puede explicar por qué una automatización útil en fase de ejecución no tiene el mismo perímetro que una automatización Revit de diseño. También debe recordar que la responsabilidad permanece en la cadena BIM y estructural existente.
Diferencia con Civil 3D MCP
El MCP Civil 3D se basa en C# compilado por Roslyn dentro de Civil 3D. Tekla MCP Server, en cambio, propone una gran superficie de herramientas nombradas y anotadas, con modo de solo lectura y tags de exclusión. Esta granularidad hace que el perímetro sea más legible para un piloto.
El riesgo no desaparece. Existen herramientas destructivas, las macros pueden actuar ampliamente y los planos pueden actualizarse o modificarse. Pero la documentación ofrece al menos palancas de gobernanza: read_only, excluded_tags, separación por categorías, recursos de proyecto y logs.
Seguridad, solo lectura y límites
Idea clave: el modo de solo lectura es la funcionalidad de gobernanza más importante del servidor. Permite exponer inspección, selección y navegación sin presentar las herramientas que escriben en el modelo.
Modo read_only y tags
La documentación de configuración indica que read_only en true expone solo herramientas anotadas readOnlyHint=true. Las herramientas de consulta, selección y navegación siguen disponibles porque no modifican el modelo. Las herramientas que escriben, sean aditivas o destructivas, quedan ocultas.
excluded_tags también permite ocultar grupos enteros: resources, selection, view, properties, operations, components, drawings o modeling. Los dos ajustes pueden combinarse. Para un estudio o una oficina técnica, el primer escenario razonable es por tanto una auditoría en solo lectura, con logs, antes de cualquier comando de modificación.
Límites técnicos
La compatibilidad documentada está verificada en Tekla 2022 y Tekla 2026. Otras versiones pueden funcionar, pero la página de compatibilidad no las declara oficialmente soportadas. El quickstart también señala problemas posibles como conflicto con el paquete clr, ruta tekla_path incorrecta, ausencia de Net48Runtime para Tekla 2026, archivos JSON faltantes o un modelo de embeddings por descargar.
Estos límites son concretos. Significan que el bloqueo puede venir de Python, Tekla, .NET, una ruta Windows, configuración JSON o un modelo HuggingFace. Una organización sin referente técnico debe prever esta realidad antes de prometer un asistente operativo.
Posición de Educasium
Idea clave: Educasium puede presentar Tekla MCP Server como un conector serio a estudiar para estructura, pero no como una solución ya desplegada por Educasium. Las afirmaciones de esta página vienen de fuentes GitHub verificadas, no de un retorno de obra.
Lo que podemos decir
Podemos decir que el repositorio existe, que es GPLv3, que indica FastMCP 3.0 en el README y fastmcp 3.4.5 en requirements.txt, que está en versión 0.2.3 en pyproject, que pide Python 3.11 o superior y que declara pruebas en Tekla 2022 y Tekla 2026. Podemos decir que propone modo solo lectura, tags de exclusión, descubrimiento de recursos de proyecto, herramientas de selección, propiedades, vistas, componentes, operaciones, dibujos y modelado.
No debemos decir que Educasium lo instaló en una oficina de estructura, que reduce errores de planos ni que sustituye una revisión de ingeniería. Esos beneficios requerirían mediciones en un proyecto real. Sin protocolo, deben seguir siendo hipótesis de piloto.
Implementación hipotética
Una implementación hipotética empezaría con una sesión Tekla de prueba, un modelo no cliente, settings.json configurado con read_only true, logs activos y una carpeta de contexto mínima que describa convenciones de nomenclatura. La primera prueba cubriría connection_status, filtros, fases, rejillas, selección, propiedades y cajas envolventes. Ninguna herramienta de modificación se expondría en esta fase.
La segunda prueba activaría solo una categoría controlada, por ejemplo dibujos en lectura y exportación, o modelado sobre un modelo descartable. La tercera compararía los resultados con un procedimiento humano: tiempo, errores, elementos modificados, capacidad de vuelta atrás y legibilidad de logs. Solo después de este encuadre un equipo puede decidir si el conector merece un piloto más amplio.
Fuentes y siguiente lectura
Idea clave: esta página se escribió a partir de fuentes GitHub verificadas el 26 de agosto de 2026. Las cifras GitHub evolucionarán, pero el estado GPLv3, la configuración, el modo solo lectura y las categorías de herramientas deben seguir siendo los primeros puntos de verificación.
Para continuar, compare Tekla MCP Server con Revit MCP, Civil 3D MCP y CAD-MCP. Tekla MCP Server es probablemente el más especializado de los cuatro para equipos de estructura y ejecución. También es uno de los que exige preparar la gobernanza de acceso antes de la demostración, no después.