Tekla MCP Server connecte des clients compatibles MCP à Tekla Structures pour automatiser des tâches de modélisation, de sélection, de vues, de propriétés, de composants, d'opérations et de plans. Le dépôt teknovizier/tekla_mcp_server décrit un serveur Python fondé sur FastMCP, avec découverte des ressources projet et un mode lecture seule. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence GPLv3, comptait 46 étoiles et 18 forks, et sa documentation indiquait des tests sur Tekla 2022 et Tekla 2026.
Pour une agence d'architecture, Tekla MCP ne remplace pas un connecteur BIM généraliste comme Revit MCP. Il vise surtout les équipes structure, béton préfabriqué, acier, exécution et plans de fabrication qui travaillent déjà dans Tekla Structures. Sa valeur vient moins d'un effet de démonstration IA que de sa capacité à lire, sélectionner, filtrer, modifier et contrôler des objets métier très précis.
Sommaire
- Ce que fait Tekla MCP Server
- Installation et architecture
- Capacités métier
- Comparaison avec les MCP BIM et CAD
- Sécurité, lecture seule et limites
- Position Educasium
- Sources et suite logique
Ce que fait Tekla MCP Server
À retenir : Tekla MCP Server expose Tekla Structures comme un environnement interrogeable et pilotable par un assistant IA. Sa documentation distingue les outils lecture seule, les outils créatifs qui ajoutent des objets, et les outils destructifs qui modifient ou suppriment des données existantes.
Familles d'outils
La référence officielle classe les outils en sélection, composants, propriétés, vues, opérations, dessins et modélisation. La sélection permet de choisir des éléments par filtre, nom de filtre, GUID, assemblage ou pièce principale. Les propriétés permettent de lire les objets, coordonnées, boîtes englobantes, différences entre éléments, découpes et UDAs. Les vues couvrent les labels temporaires, le zoom, le redraw, l'affichage isolé, le masquage, la coloration et l'application de filtres de vue.
Les composants et la modélisation sont plus sensibles. Le serveur peut insérer des composants, modifier ou supprimer des composants existants, placer poutres, poteaux, panneaux, dalles et grilles, déplacer, copier ou supprimer des éléments. Les opérations couvrent aussi des actions comme coupes booléennes, rattachement d'assemblages ou d'armatures, macros, clash check et création de rapports Tekla.
Dessins et contrôle qualité
La partie dessins est particulièrement riche. La référence vérifiée liste la lecture et modification de propriétés de plans, l'émission ou désémission de plans, la mise à jour de plans, l'impression PDF, l'export DWG, DXF ou DGN, l'ouverture et fermeture de plans, la lecture des vues, la lecture des annotations, la recherche d'objets non repérés, le déplacement de vues et l'alignement de coupes. Elle inclut aussi des contrôles de collisions de dessin et de cotes non attachées.
Pour une équipe structure, c'est potentiellement plus important que la génération d'une poutre. Les plans, repères, vues, collisions d'annotations et exports sont des sources fréquentes de travail répétitif. Un assistant qui peut inspecter ces éléments sous contrôle peut aider à préparer une revue, mais il ne doit pas décider seul d'émettre ou de modifier des plans de production.
Installation et architecture
À retenir : Tekla MCP Server est un projet Python 3.11+ qui exige Tekla Structures et une configuration locale précise. Il ne s'installe pas comme une extension simple à cliquer.
Prérequis et dépendances
Le quickstart demande Python 3.11 ou plus et recommande uv pip install -r requirements.txt. Le fichier pyproject vérifié indique le nom tekla-mcp-server, la version 0.2.3 et requires-python >=3.11. Le fichier requirements.txt liste fastmcp 3.4.5, pathvalidate, pydantic, pythonnet, python-dotenv, sentence-transformers et ezdxf.
pythonnet signale que le serveur parle à l'écosystème .NET de Tekla. sentence-transformers sert à la compréhension sémantique des attributs. ezdxf est utilisé dans les flux de dessin, notamment pour analyser des exports. Ces dépendances expliquent pourquoi un test doit être confié à une personne capable de diagnostiquer Python, chemins Windows, bibliothèques Tekla et configuration MCP.
Fichiers de configuration
Le quickstart demande de copier plusieurs fichiers exemple : settings.json, element_types.json, semantic_overrides.json, base_components.json et report_properties.json. settings.json contient le chemin Tekla, le dossier de contexte, read_only, excluded_tags, les paramètres d'embeddings, les tolérances et les réglages de rapports ou dessins. Le serveur lit ces fichiers au démarrage, donc toute modification demande un redémarrage.
Les variables d'environnement TEKLA_MCP_LOG_LEVEL, TEKLA_MCP_LOG_FILE_PATH et TEKLA_MCP_CONFIG_DIR permettent de fixer le niveau de log, le fichier de log et le répertoire de configuration. La documentation insiste sur les chemins absolus pour les variables de chemin. En pratique, cette architecture favorise un poste pilote documenté plutôt qu'une installation improvisée sur plusieurs machines.
Capacités métier
À retenir : Tekla MCP Server est construit pour des workflows structure et exécution, pas seulement pour dessiner des formes. Ses ressources découvrent les filtres, composants, catalogues, phases, grilles, rapports, macros et fichiers de contexte.
Ressources découvertes
Les ressources MCP incluent 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 et tekla://connection_status. Cela donne à l'assistant plus que des commandes. Il peut connaître les noms de filtres, les matériaux disponibles, les profils d'armatures, les phases et les conventions projet si elles sont décrites dans le dossier de contexte.
Cette logique est importante pour une vraie production. Un assistant qui ignore les standards de numérotation, les classes Tekla ou les noms de filtres locaux produit vite des résultats inutilisables. Les ressources projet permettent de rapprocher le langage naturel des conventions de l'équipe.
Composants et attributs sémantiques
Le README mentionne un système de handlers pour composants, avec l'exemple des lifting anchors qui sélectionnent les ancres selon le poids de l'élément et calculent leur placement selon le centre de gravité. La configuration décrit aussi base_components.json et des propriétés personnalisées exposées via tekla://components. Le serveur peut donc être adapté à des composants récurrents.
La documentation de configuration décrit un mapping sémantique des attributs avec un modèle MiniLM publié sur HuggingFace, teknovizier/minilm-tekla-attr-embed-v1, et un fallback LLM si le score est incertain. C'est utile lorsque l'utilisateur dit une expression métier au lieu du nom exact de l'attribut Tekla. La prudence reste nécessaire : tout mapping sémantique doit être testé sur un jeu de composants connu avant de l'autoriser sur un projet.
Comparaison avec les MCP BIM et CAD
À retenir : Tekla MCP Server est le connecteur le plus orienté structure et plans de fabrication dans cette série. Il complète les MCP BIM d'architecture au lieu de les remplacer.
| Option | Usage naturel | Force principale | Limite à surveiller |
|---|---|---|---|
| Tekla MCP Server | Structure, acier, béton préfabriqué, plans et composants | Outils métier, ressources projet, mode lecture seule | Configuration lourde, actions destructives, GPLv3 |
| Revit MCP | Modèle BIM bâtiment généraliste | Objets architecturaux, niveaux, pièces et extractions | Gouvernance BIM et dépendance au fork Revit |
| Civil 3D MCP | VRD, topographie, surfaces et tracés | C# Roslyn dans Civil 3D, bibliothèques de skills | Exécution de code et périmètre infrastructure |
| CAD-MCP | Dessin DWG via AutoCAD, GstarCAD ou ZWCAD | COM Windows multi-CAD | Moins riche en objets structure métier |
Différence avec Revit MCP
Revit MCP agit sur une maquette bâtiment plus généraliste : murs, sols, portes, niveaux, grilles, pièces et nomenclatures. Tekla MCP Server descend davantage dans les objets structure, les composants, les UDAs, les assemblages, les armatures et les dessins. La différence est donc moins une question de technologie IA qu'une question de métier.
Pour Educasium, cette page doit être utile aux architectes qui collaborent avec bureaux structure et entreprises. Elle peut expliquer pourquoi une automatisation utile en phase exécution n'a pas le même périmètre qu'une automatisation Revit de conception. Elle doit aussi rappeler que la responsabilité reste dans la chaîne BIM et structure existante.
Différence avec Civil 3D MCP
Le MCP Civil 3D repose sur du C# compilé via Roslyn dans Civil 3D. Tekla MCP Server, lui, propose une grande surface d'outils nommés et annotés, avec un mode lecture seule et des tags d'exclusion. Cette granularité rend le périmètre plus lisible pour un pilote.
Le risque ne disparaît pas. Les outils destructifs existent, les macros peuvent agir largement, et les plans peuvent être mis à jour ou modifiés. Mais la documentation donne au moins des leviers de gouvernance : read_only, excluded_tags, séparation des catégories, ressources projet et logs.
Sécurité, lecture seule et limites
À retenir : le mode lecture seule est la fonctionnalité de gouvernance la plus importante du serveur. Il permet d'exposer inspection, sélection et navigation sans présenter les outils qui écrivent dans le modèle.
Mode read_only et tags
La documentation configuration indique que read_only à true expose seulement les outils annotés readOnlyHint=true. Les outils de requête, sélection et navigation restent disponibles, car ils ne modifient pas le modèle. Les outils qui écrivent, qu'ils soient additifs ou destructifs, sont masqués.
excluded_tags permet aussi de cacher des groupes entiers : resources, selection, view, properties, operations, components, drawings ou modeling. Les deux réglages peuvent être combinés. Pour une agence ou un bureau d'études, le premier scénario raisonnable est donc un audit en lecture seule, avec journalisation, avant toute commande de modification.
Limites techniques
La compatibilité documentée est vérifiée sur Tekla 2022 et Tekla 2026. Les autres versions peuvent fonctionner, mais la page de compatibilité ne les déclare pas officiellement supportées. Le quickstart signale aussi des problèmes possibles comme un conflit de package clr, un mauvais chemin tekla_path, l'absence de Net48Runtime pour Tekla 2026, des fichiers JSON manquants ou un modèle d'embedding à télécharger.
Ces limites sont concrètes. Elles veulent dire que le blocage peut venir de Python, de Tekla, de .NET, d'un chemin Windows, d'une configuration JSON ou d'un modèle HuggingFace. Une organisation qui n'a pas de référent technique doit prévoir cette réalité avant de promettre un assistant opérationnel.
Position Educasium
À retenir : Educasium peut présenter Tekla MCP Server comme un connecteur sérieux à étudier pour la structure, mais pas comme une solution déjà déployée par Educasium. Les affirmations de cette page viennent des sources GitHub vérifiées, pas d'un retour chantier.
Ce que nous pouvons dire
Nous pouvons dire que le dépôt existe, qu'il est GPLv3, qu'il indique FastMCP 3.0 dans le README et fastmcp 3.4.5 dans requirements.txt, qu'il est en version 0.2.3 dans pyproject, qu'il demande Python 3.11 ou plus, et qu'il déclare des tests sur Tekla 2022 et Tekla 2026. Nous pouvons dire qu'il propose un mode lecture seule, des tags d'exclusion, une découverte de ressources projet, des outils de sélection, propriétés, vues, composants, opérations, dessins et modélisation.
Nous ne devons pas dire qu'Educasium l'a installé chez un bureau structure, qu'il réduit les erreurs de plans, ni qu'il remplace une revue d'ingénieur. Ces bénéfices demanderaient des mesures sur un projet réel. Sans protocole, ils doivent rester des hypothèses de pilote.
Implémentation hypothétique
Une implémentation hypothétique commencerait par une session Tekla de test, avec un modèle non client, settings.json configuré en read_only true, logs actifs et dossier de contexte minimal décrivant les conventions de nommage. Le premier test porterait sur connection_status, filtres, phases, grilles, sélection, propriétés et boîtes englobantes. Aucun outil de modification ne serait exposé à ce stade.
Le deuxième test activerait seulement une catégorie contrôlée, par exemple dessins en lecture et export, ou modélisation sur un modèle jetable. Le troisième test comparerait les résultats à une procédure humaine : temps, erreurs, éléments modifiés, capacité de retour arrière et lisibilité des logs. C'est seulement après ce cadrage qu'une équipe peut décider si le connecteur mérite un pilote plus large.
Sources et suite logique
À retenir : cette page a été écrite depuis les sources GitHub vérifiées le 26 août 2026. Les chiffres GitHub évolueront, mais le statut GPLv3, la configuration, le mode lecture seule et les catégories d'outils doivent rester les premiers points de vérification.
Pour continuer, comparez Tekla MCP Server avec Revit MCP, Civil 3D MCP et CAD-MCP. Tekla MCP Server est probablement le plus spécialisé des quatre pour les équipes structure et exécution. Il est aussi l'un de ceux où la gouvernance d'accès doit être préparée avant la démonstration, pas après.