Robust MCP Bridge Workbench/de

Beschreibung

Der Arbeitsbereich Robust MCP Bridge ist ein serverseitiger Verbindungspunkt, der eine Brücke (engl. Bridge) zum Robust MCP-Server bildet, wodurch externe Anwendungen FreeCAD über das Model Context Protocol (MCP) steuern können. Der Arbeitsbereich läuft innerhalb von FreeCAD und stellt XML-RPC- und JSON-RPC-Schnittstellen bereit, mit denen externe MCP-Clients eine Verbindung herstellen können.

Dieser Arbeitsbereich ist für die Verwendung mit dem Robust MCP-Server (verfügbar auf PyPI) konzipiert, der es KI-Assistenten wie Claude ermöglicht, über natürliche Sprache mit FreeCAD zu interagieren. Die vollständige Dokumentation und der Quellcode sind unter github/spkane/freecad-robust-mcp-and-more zu finden, wo der MCP-Server, Brücke und einige FreeCAD-Makros gefunden werden können, die für verschiedene Zwecke verwendet werden, die nicht unbedingt mit KI oder der MCP-Arbeit zusammenhängen.

Wichtigste Merkmale:

• Symbolleistensteuerelemente zum Starten/Beenden der MCP-Brücke.
• Statusanzeige für den Verbindungsstatus (grün = läuft, rot = angehalten).
• XML-RPC-Server auf konfigurierbarem Port (Standard: 9875).
• JSON-RPC-Socket-Server auf konfigurierbarem Port (Standard: 9876).
• Unterstützung des Kopflos-Modus für Automatisierung und CI/CD-Pipelines.
• Thread-sicheres Warteschlangensystem für sichere FreeCAD-Operationen.
• Konfigurierbarer Autostart beim Start von FreeCAD.

Installation

Über den Addon-Manager (empfohlen)

1. FreeCAD öffnen.
2. Zum Extras → Addon-Manager gehen.
3. Nach „Robust MCP Bridge“ suchen.
4. Auf Installieren klicken.
5. FreeCAD neu starten.

Manuelle Installation

Die neueste Version von GitHub-Veröffentlichungen herunterladen und sie in das FreeCAD Mod-Verzeichnis extrahieren:

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

Anwendung

Grafischer Benutzeroberflächenmodus

1. Mit der Arbeitsbereichsauswahl zum Arbeitsbereich Robust MCP Bridge wechseln.
2. In der Symbolleiste auf Start Bridge klicken.
3. Die Statusanzeige wird während der Ausführung grün.
4. Externe MCP-Clients können nun eine Verbindung zu localhost:9875 (XML-RPC) oder localhost:9876 (Socket) herstellen.

Um die Brücke (Bridge) zu stoppen, in der Symbolleiste auf Bridge Stop klicken.

Kopfloser Modus

Für Automatisierung und CI/CD-Pipelines kann die Brücke ohne grafische Benutzeroberfläche ausgeführt werden:

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

Die Brücke startet und hält FreeCAD am Laufen, bis Strg+C gedrückt wird.

Konfiguration

Zugriff auf die Einstellungen über Bearbeiten → Einstellungen → Robust MCP Bridge oder Robust MCP Bridge → MCP Bridge-Preferences...

Funktionen nach Modus

MCP-Clients verbinden

Dieser Arbeitsbereich stellt den Server bereit, mit dem sich MCP-Clients verbinden. Um sie mit KI-Assistenten wie Claude zu verwenden, wird ein MCP-Client wie den Robust MCP Server benötigt:

pip install freecad-robust-mcp

Oder mit uv:

uv tool install freecad-robust-mcp

Die vollständige Dokumentation zur Konfiguration von MCP-Clients ist im GitHub-Repository zu finden.

Fehlerbehebung

Brücke startet nicht

1. Die FreeCAD-Python-Konsole (Ansicht → Fenster → Python-Konsole) auf Fehlermeldungen überprüfen.
2. Sicherstellen, dass kein anderer Prozess die Ports 9875/9876 verwendet.
3. Versuchen, FreeCAD neu zu starten.

Verbindung abgelehnt

1. Überprüfen, ob die Bridge läuft (grüne Statusanzeige in der Symbolleiste).
2. Überprüfen, ob die Ports in den Arbeitsbereichs-Einstellungen mit der MCP-Client-Konfiguration übereinstimmen.
3. Wenn eine Verbindung über Docker hergestellt werden soll, host.docker.internal anstelle von localhost verwenden.

Kopfloser-Modus startet nicht

1. Sicherstellen, dass freecadcmd (nicht freecad) verwendet wird.
2. Überprüfen, ob der Skriptpfad für die Installation korrekt ist.
3. FreeCAD zunächst testen: freecadcmd -c "print('test')".

Verweise

• Vollständige Dokumentation - Vollständige Handbücher, API-Referenz und Tutorials.
• GitHub-Repository - Quellcode, Dokumentation und Problemverfolgung (Issue Tracker).
• Robust MCP Server auf PyPI - Der MCP-Client, der eine Verbindung zu dieser Brücke (Bridge) herstellt.
• Model Context Protocol - Die Protokollspezifikation.