Donate

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é)

1. Lancez FreeCAD.
2. Allez dans Outils → Gestionnaire d'extensions.
3. Recherchez « Robust MCP Bridge ».
4. Cliquez sur Installer.
5. 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

1. Passez à l'atelier Robust MCP Bridge à l'aide du sélecteur d'atelier.
2. Cliquez sur Start Bridge dans la barre d'outils.
3. L'indicateur d'état devient vert lorsque l'application est en cours d'exécution.
4. 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....

Fonctions par mode

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

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

Connexion refusée

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

Le mode sans affichage ne démarre pas

1. Assurez-vous d'utiliser freecadcmd (et non freecad).
2. Vérifiez que le chemin d'accès au script est correct pour votre installation.
3. 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.