Robust MCP Bridge Workbench/fr

Description

L'atelier Robust MCP Bridge est le point de connexion côté serveur qui fait le pont avec le Robust MCP Server, qui permet à des applications externes de contrôler FreeCAD via le Model Context Protocol (MCP). L'atelier s'exécute dans FreeCAD et expose des interfaces XML-RPC et JSON-RPC auxquelles les clients MCP externes peuvent se connecter.

Cet atelier est conçu pour fonctionner avec le Robust MCP Server (disponible sur PyPI), qui permet à des assistants IA tels que Claude d'interagir avec FreeCAD via un langage naturel. La documentation complète et le code source sont disponibles sur github/spkane/freecad-robust-mcp-and-more, où vous trouverez le serveur MCP, Bridge et certaines macros FreeCAD utilisées à diverses fins, pas nécessairement liées à l'IA ou au travail MCP.

Principales fonctions :

Barre d'outils pour démarrer/arrêter le pont MCP.
Indicateur d'état affichant l'état de la connexion (vert = en cours, rouge = arrêté).
Serveur XML-RPC sur un port configurable (par défaut : 9875).
Serveur socket JSON-RPC sur port configurable (par défaut : 9876).
Prise en charge du mode sans affichage pour l'automatisation et les pipelines CI/CD.
Système de file d'attente thread-safe garantissant la sécurité des opérations FreeCAD.
Démarrage automatique configurable au lancement de FreeCAD.

Installation

Via le gestionnaire d'extensions (recommandé)

Lancez FreeCAD.
Allez dans Outils → Gestionnaire d'extensions.
Recherchez « Robust MCP Bridge ».
Cliquez sur Installer.
Redémarrez FreeCAD.

Installation manuelle

Téléchargez la dernière version depuis les releases GitHub et extrayez-la dans votre répertoire FreeCAD Mod :

Linux: ~/.local/share/FreeCAD/Mod/FreecadRobustMCPBridge/
macOS: ~/Library/Application Support/FreeCAD/Mod/FreecadRobustMCPBridge/
Windows: %APPDATA%/FreeCAD/Mod/FreecadRobustMCPBridge/

Utilisation

Mode interface utilisateur

Passez à l'atelier Robust MCP Bridge à l'aide du sélecteur d'atelier.
Cliquez sur Start Bridge dans la barre d'outils.
L'indicateur d'état devient vert lorsque l'application est en cours d'exécution.
Les clients MCP externes peuvent désormais se connecter à localhost:9875 (XML-RPC) ou localhost:9876 (Socket).

Pour arrêter le bridge, cliquez sur Stop Bridge dans la barre d'outils.

Mode sans affichage

Pour l'automatisation et les pipelines CI/CD, le bridge peut fonctionner sans l'interface graphique :

Linux :

freecadcmd ~/.local/share/FreeCAD/Mod/FreecadRobustMCPBridge/freecad_mcp_bridge/blocking_bridge.py

macOS :

/Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd \
    ~/Library/Application\ Support/FreeCAD/Mod/FreecadRobustMCPBridge/freecad_mcp_bridge/blocking_bridge.py

Le bridge démarrera et maintiendra FreeCAD en cours d'exécution jusqu'à ce que vous appuyiez sur Ctrl+C.

Configuration

Accédez aux préférences via Édition → Préférences → Robust MCP Bridge ou Robust MCP Bridge → MCP Bridge Preferences....

Paramètre	Description	Par défaut
Auto-start bridge	Démarrer automatiquement le pont au lancement de FreeCAD	Désactivé
Show status indicator	Afficher l'état de la connexion dans la barre d'état de FreeCAD	Activé
XML-RPC Port	Port pour les connexions XML-RPC	9875
Socket Port	Port pour les connexions socket JSON-RPC	9876

Fonctions par mode

Fonction	Mode affichage	Mode sans affichage
Création d'objets	Oui	Oui
Opérations booléennes	Oui	Oui
Exportation (STEP, STL, 3MF)	Oui	Oui
Exécution de macros	Oui	Oui
Gestion des documents	Oui	Oui
Captures d'écran	Oui	Non
Couleurs/visibilité des objets	Oui	Non
Contrôle de la caméra/vue	Oui	Non

Connexion des clients MCP

Cet atelier fournit le serveur auquel se connectent les clients MCP. Pour l'utiliser avec des assistants IA tels que Claude, vous avez besoin d'un client MCP tel que le Robust MCP Server :

pip install freecad-robust-mcp

Ou en utilisant uv :

uv tool install freecad-robust-mcp

Consultez le dépôt sur GitHub pour obtenir la documentation complète sur la configuration des clients MCP.

Dépannage

Bridge ne démarre pas

Vérifiez la console Python de FreeCAD (Affichage → Panneaux → Console Python) pour voir s'il y a des messages d'erreur.
Assurez-vous qu'aucun autre processus n'utilise les ports 9875/9876.
Essayez de redémarrer FreeCAD.

Connexion refusée

Vérifiez que le bridge fonctionne (indicateur d'état vert dans la barre d'outils).
Vérifiez que les ports correspondent entre les préférences de l'atelier et la configuration de votre client MCP.
Si vous vous connectez à partir de Docker, utilisez host.docker.internal au lieu de localhost.

Le mode sans affichage ne démarre pas

Assurez-vous d'utiliser freecadcmd (et non freecad).
Vérifiez que le chemin d'accès au script est correct pour votre installation.
Testez d'abord FreeCAD : freecadcmd -c "print('test')".

Liens

Dernière version
Serveur MCP robuste sur PyPI : le serveur MCP qui se connecte à ce pont.
Documentation complète : guides complets, référence API et tutoriels.
Dépôt sur GitHub : code source et suivi des problèmes.
Protocole de contexte de modèle : spécifications du protocole.