FreeCAD MCP connecte Claude Desktop à FreeCAD, le logiciel de CAO paramétrique open source. Le dépôt neka-nat/freecad-mcp permet de créer des documents, créer et éditer des objets, supprimer des objets, exécuter du code Python dans FreeCAD, insérer des pièces depuis la bibliothèque FreeCAD, récupérer des vues, lister les objets et lancer une analyse FEM via CalculiX. C'est l'un des connecteurs CAD les plus adoptés de cette sélection, avec 1902 étoiles et 256 forks au moment de la vérification GitHub du 26 août 2026.
Pour une agence d'architecture, FreeCAD MCP n'a pas le même rôle que Revit MCP ou Archicad MCP. FreeCAD n'est pas l'outil BIM principal de la plupart des agences françaises, mais il peut être utile pour prototyper une pièce, expliquer la modélisation paramétrique, générer une géométrie simple ou tester une automatisation open source sans licence commerciale. Le connecteur est donc intéressant surtout comme laboratoire CAO piloté par IA.
Sommaire
- Ce que fait FreeCAD MCP
- Installation et architecture
- Capacités utiles
- Comparaison avec les MCP BIM et CAD
- Sécurité, remote et limites
- Position Educasium
- Sources et suite logique
Ce que fait FreeCAD MCP
À retenir : FreeCAD MCP donne à Claude une interface d'action sur FreeCAD, avec création d'objets, édition, capture de vue, bibliothèque de pièces et exécution Python. Sa force est la flexibilité open source ; sa limite est le niveau technique requis.
Outils exposés
Le README liste create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, get_parts_list, get_rpc_status et run_fem_analysis. Les outils qui retournent des captures acceptent include_screenshot et view_name pour supprimer ou orienter l'image. Le mode only_text_feedback peut désactiver globalement les captures pour économiser des tokens.
Cette surface est plus large qu'un simple générateur de formes. L'assistant peut inspecter le document, modifier un objet existant, insérer une pièce depuis la bibliothèque officielle FreeCAD-library, ou lancer une analyse FEM sur un FemAnalysis existant. Pour une formation, c'est un bon support pour montrer la différence entre objet paramétrique, capture de vue et script Python.
Python dans FreeCAD
L'outil execute_code est le point le plus puissant. Il permet d'exécuter du Python dans FreeCAD, ce qui ouvre presque tout le périmètre de l'API FreeCAD. C'est exactement ce qui rend le connecteur utile pour des workflows avancés, mais aussi ce qui impose une discipline de test.
Une consigne mal cadrée peut créer des objets cassés, bloquer le thread GUI ou modifier un document de façon difficile à relire. Le README signale d'ailleurs qu'après une exception execute_code sur un build de développement FreeCAD, il faut inspecter les nouveaux objets FeaturePython avant de les modifier ou supprimer, car un objet sans Proxy requis peut bloquer le thread GUI.
Installation et architecture
À retenir : FreeCAD MCP combine un add-on FreeCAD local et un serveur MCP lancé via uvx ou uv. Il ne suffit pas d'ajouter une ligne dans Claude Desktop.
Add-on FreeCAD
Le README donne les dossiers d'add-on pour Windows, macOS et plusieurs distributions Linux. L'installation consiste à copier addon/FreeCADMCP dans le dossier Mod de FreeCAD, puis à redémarrer FreeCAD. L'utilisateur sélectionne ensuite le workbench MCP Addon et lance le serveur RPC depuis la barre d'outils FreeCAD MCP.
Le serveur RPC peut aussi démarrer automatiquement si l'option Auto-Start Server est activée dans le menu FreeCAD MCP. Le réglage est sauvegardé dans freecad_mcp_settings.json et persiste entre sessions. Ce détail est utile pour un poste récurrent, mais en phase pilote il vaut mieux garder le démarrage manuel afin de savoir quand l'outil est actif.
Serveur MCP et prérequis Python
La configuration Claude Desktop utilise uvx avec l'argument freecad-mcp. Le pyproject vérifié indique un package freecad-mcp en version 0.1.22, sous licence MIT, avec Python 3.12 ou plus et des dépendances mcp et validators. Pour un développeur, le README propose aussi un lancement via uv depuis un clone local du dépôt.
Ce fonctionnement est plus simple que les connecteurs qui exigent Visual Studio ou des DLL Civil 3D, mais il reste technique. Il faut installer l'add-on au bon endroit, lancer ou auto-lancer le RPC côté FreeCAD, puis configurer le client MCP côté Claude. Une erreur sur l'un de ces trois niveaux suffit à faire échouer la connexion.
Capacités utiles
À retenir : FreeCAD MCP est pertinent pour prototyper, enseigner et automatiser des objets paramétriques simples. Il ne remplace pas un workflow BIM d'agence.
Modélisation et bibliothèque de pièces
Les outils create_object, edit_object et delete_object couvrent la manipulation directe d'objets FreeCAD. insert_part_from_library et get_parts_list ajoutent un lien vers FreeCAD-library, ce qui permet d'insérer des pièces existantes au lieu de tout reconstruire. Pour un atelier pédagogique, cela facilite les démonstrations : créer un document, ajouter un volume, modifier ses paramètres, insérer une pièce, puis capturer la vue.
Dans une agence, ce périmètre peut servir à explorer des détails, objets, assemblages simples ou variantes de géométrie. Il n'est pas conçu comme substitut d'un modèle Revit, Archicad ou Rhino complet. Sa valeur vient surtout de l'ouverture : FreeCAD et Python permettent de comprendre ce que l'automatisation fait réellement.
FEM et CalculiX
run_fem_analysis lance le solveur CalculiX sur un FemAnalysis existant et retourne des résultats de synthèse : contrainte de von Mises maximale, déplacement maximal, nombre de noeuds et dossier de travail. Le README précise qu'il auto-crée un SolverCcxTools si l'analyse n'en a pas, et renvoie vers un exemple cantilever_fem.py.
Cette capacité est intéressante mais ne doit pas être survendue. Elle peut aider à démontrer une chaîne de calcul ou à tester une pièce simple, mais elle ne remplace pas une étude structure qualifiée. Tout résultat FEM doit rester sous contrôle d'un ingénieur compétent, surtout si une décision de conception en dépend.
Comparaison avec les MCP BIM et CAD
À retenir : FreeCAD MCP est le plus ouvert et expérimental des connecteurs CAD de cette série. Il est moins métier qu'un MCP Revit, mais plus accessible pour explorer la CAO programmable.
| Option | Usage naturel | Force principale | Limite à surveiller |
|---|---|---|---|
| FreeCAD MCP | Prototyper et automatiser FreeCAD | Open source, Python, objets paramétriques, captures | execute_code et maturité workflow agence |
| Revit MCP | Agir sur une maquette BIM bâtiment | Outils BIM prêts à l'emploi | Dépendance à Revit et gouvernance d'écriture |
| AutoCAD MCP | Automatiser AutoCAD LT et DXF | Backends AutoCAD et ezdxf | Centré DWG/DXF, moins paramétrique |
FreeCAD MCP face à Revit et Archicad
Le MCP Revit et le MCP Archicad visent des logiciels BIM utilisés directement en production d'agence. FreeCAD MCP vise un logiciel open source plus transversal. Cela le rend moins immédiatement compatible avec les livrables courants d'une agence, mais plus intéressant pour apprendre la logique d'automatisation.
Une agence Revit ou Archicad ne devrait pas migrer de workflow à cause de FreeCAD MCP. En revanche, elle peut l'utiliser comme environnement de test pour comprendre comment un assistant crée, modifie et inspecte des objets CAO sans exposer une maquette client.
FreeCAD MCP face à AutoCAD MCP
Le MCP AutoCAD est plus orienté dessin, calques, blocs, annotations et DXF. FreeCAD MCP est plus orienté objets paramétriques, scripts Python, captures et simulation simple. Les deux n'ont donc pas le même usage.
Si l'objectif est de produire ou modifier un plan DWG/DXF, AutoCAD MCP est plus naturel. Si l'objectif est d'explorer une géométrie paramétrique open source ou de montrer comment Python pilote une CAO, FreeCAD MCP est plus pédagogique.
Sécurité, remote et limites
À retenir : FreeCAD MCP démarre localement par défaut, mais peut accepter des connexions réseau si l'utilisateur l'active. Cette option doit être traitée avec prudence.
Connexions locales et remote
Par défaut, le serveur RPC n'accepte pas les connexions distantes et écoute localhost. Le README documente une option Remote Connections qui bind le serveur sur 0.0.0.0 au redémarrage, avec une liste d'IP ou sous-réseaux autorisés. 127.0.0.1 reste la valeur par défaut et les entrées invalides sont rejetées.
Pour une agence, la règle doit être simple : rester en localhost pendant les essais. Les connexions distantes ne doivent être activées que si le besoin est clair, avec réseau maîtrisé, allowlist limitée et validation IT. Un serveur capable d'exécuter du Python dans FreeCAD ne doit pas être exposé largement.
GUI dispatch et objets cassés
Le README signale que si une opération GUI dépasse son timeout après avoir démarré, le bridge renvoie GUI_DISPATCH_STUCK et rejette les opérations GUI suivantes. get_rpc_status sert alors à identifier l'opération encore en cours. FreeCAD ne peut pas annuler sans risque un travail GUI bloqué ; si l'état ne redevient pas sain après la fin de l'opération, il faut redémarrer FreeCAD.
Cette limite est importante en production. Elle signifie qu'un mauvais script ne se corrige pas toujours par un simple retry. Il faut sauvegarder, tester sur document séparé et éviter de chaîner des opérations lourdes sans contrôle intermédiaire.
Position Educasium
À retenir : Educasium peut utiliser FreeCAD MCP comme environnement d'apprentissage, mais ne doit pas le présenter comme un outil déjà validé dans une agence cliente.
Retour d'expérience disponible
Educasium n'a pas encore déployé FreeCAD MCP dans une agence cliente ni mesuré de gain de temps vérifié sur un flux CAO réel. Cette page repose sur le README, pyproject, exemples et métadonnées GitHub vérifiés. Elle décrit donc une capacité open source, pas une étude de cas.
L'intérêt pédagogique est toutefois fort. FreeCAD MCP permet de montrer la relation entre prompt, objet paramétrique, capture, code Python et résultat. Il est aussi adapté à des ateliers où l'on veut éviter d'utiliser une licence propriétaire ou une maquette confidentielle.
Hypothetical implementation
Hypothetical implementation. Pour un pilote Educasium, la première étape serait d'installer l'add-on FreeCADMCP, lancer le RPC manuellement et connecter Claude Desktop via uvx. Les premiers tests devraient rester sur create_document, create_object, get_objects, get_view et edit_object avec include_screenshot activé, pour vérifier visuellement chaque étape.
execute_code et run_fem_analysis viendraient plus tard, sur documents tests et scripts courts. Les connexions remote resteraient désactivées. Le critère de réussite serait une séquence reproductible : créer un objet simple, modifier un paramètre, capturer une vue, puis expliquer ce que le code a fait.
Sources et suite logique
À retenir : les informations de cette page viennent du dépôt GitHub et ont été vérifiées le 26 août 2026. Les versions, outils, paramètres screenshots, remote connections et prérequis Python viennent du README et du pyproject.
À lire ensuite
Pour les workflows BIM bâtiment, comparez FreeCAD MCP avec le MCP Revit et le MCP Archicad. Pour les flux CAD 2D, lisez aussi AutoCAD MCP et CAD-MCP.
Pour construire une stratégie d'adoption plus large, consultez le comparatif des logiciels IA pour architectes et la formation Maîtriser l'IA en architecture.