🐍 PyNet Platform Bridge (MCP)

PyNet Platform Bridge (MCP) ist die Ausführungsschicht, die es KI-Modellen ermöglicht, Autodesk-Tools in Echtzeit zu steuern.

Sie verbindet natürliche Sprache → Python → Autodesk-Desktop-Tools (Navisworks, Revit, AutoCAD) und ermöglicht es der KI, BIM-Workflows autonom zu generieren, auszuführen und zu verfeinern.

Zu den verfügbaren Integrationen gehören Navisworks Manage, Revit und AutoCAD.

Diese Bridge fungiert als Bindeglied zwischen KI-Logik und Autodesk-Desktop-APIs und ermöglicht die dynamische Erstellung von Benutzeroberflächen, die Ausführung von Skripten und die Automatisierung von BIM-Prozessen mithilfe natürlicher Sprache.

🔄 Funktionsweise

1. Der Benutzer beschreibt eine Aufgabe in natürlicher Sprache.

2. Die KI generiert ein Python-Skript.

3. PyNet Bridge validiert und sendet das Skript.

4. Das PyNet-Plugin führt es innerhalb von Autodesk aus.

5. Die Ergebnisse werden an die KI zurückgegeben.

Dies macht aus einer KI von einem Chatbot zu einer Ausführungs-Engine für BIM.

Related MCP server: ACP-MCP-Server

🚀 Was PyNet Bridge so leistungsstark macht

• KI → Aktion: Verwandelt KI-generierten Code in echte Aktionen innerhalb von Navisworks/Revit

• Echtzeit-Ausführung: Skripte sofort ausführen, ohne die BIM-Umgebung zu verlassen

• Dynamische UI-Erstellung: Lassen Sie die KI Tools, Schaltflächen und Workflows im laufenden Betrieb erstellen

• Zuverlässige Kommunikation: Schnelle und stabile lokale IPC

• Modellbewusste Automatisierung: Arbeitet direkt an Live-BIM-Modellen

🛠️ Installation

✅ Option A — Automatischer Installer (empfohlen)

Öffnen Sie PowerShell und führen Sie Folgendes aus:

irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install.ps1 | iex

Dies führt automatisch folgende Schritte aus:

1. Überprüfung, ob Python 3.10+ installiert ist

2. Installation von pynet-mcp-bridge von PyPI (via uv oder pip)

3. Automatische Erkennung und Konfiguration aller installierten KI-Clients:

   • Claude Desktop (Standard- und Microsoft Store-Versionen)

   • Claude Code (VS Code-Erweiterung / CLI)

   • Cline (VS Code-Erweiterung)

   • Roo Code (VS Code-Erweiterung)

Das Paket pynet-mcp-bridge enthält:

Starten Sie Ihre KI-Client(s) nach der Installation neu, um die Änderungen anzuwenden.

📦 Python Libraries Starter Pack (optional)

Installieren Sie die empfohlenen Python-Bibliotheken für Navisworks/Revit-Skripte mit PyNET:

irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install-libraries.ps1 | iex

Dies installiert:

Dies sind die Drittanbieter-Bibliotheken, die unter Allowed Python Imports aufgeführt sind. Standard-Bibliotheksmodule (json, sys, re usw.) sind bereits in Python enthalten.

Voraussetzungen

• PyNet Platform-Plugin in Navisworks/Revit installiert.

• Python 3.10 oder höher → python.org

  ⚠️ Python 3.14 wird noch nicht unterstützt. Die pythonnet-Laufzeitumgebung unterstützt derzeit Python 3.7 bis 3.13. Wenn Sie auf eine System.NotSupportedException stoßen, die eine nicht unterstützte ABI-Version erwähnt, installieren Sie Python 3.12 oder 3.13 und konfigurieren Sie PyNet für deren Verwendung.

• uv → docs.astral.sh/uv

• Git → git-scm.com — erforderlich für das korrekte Funktionieren der VS Code-Erweiterungen (Claude Code, Cline, Roo Code).

• Für Cline / Roo Code: VS Code → code.visualstudio.com

🔧 Option B — Manuelle Installation

1. Installieren Sie das Paket:

uv tool install pynet-mcp-bridge

Oder mit pip:

pip install pynet-mcp-bridge

2. Konfigurieren Sie Claude Desktop:

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

• Standard: %APPDATA%\Claude\claude_desktop_config.json

• Microsoft Store: %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json

{
 "mcpServers": {
 "pynet-bridge": {
 "command": "pynet-bridge",
 "args": []
 }
 }
}

3. Konfigurieren Sie Claude Code (VS Code-Erweiterung):

Fügen Sie dies zu %USERPROFILE%\.claude.json hinzu:

{
 "mcpServers": {
 "pynet-bridge": {
 "type": "stdio",
 "command": "pynet-bridge",
 "args": []
 }
 }
}

4. Konfigurieren Sie Cline:

Fügen Sie dies zu %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json hinzu:

{
 "mcpServers": {
 "pynet-bridge": {
 "type": "stdio",
 "command": "pynet-bridge",
 "args": []
 }
 }
}

5. Konfigurieren Sie Roo Code:

Fügen Sie dies zu %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json hinzu:

{
 "mcpServers": {
 "pynet-bridge": {
 "type": "stdio",
 "command": "pynet-bridge",
 "args": []
 }
 }
}

🛠️ Verfügbare MCP-Tools

Diese Tools ermöglichen es der KI, die PyNet-Umgebung vollständig zu steuern, von der UI-Erstellung bis zur Skriptausführung und Systemüberwachung. Sobald die Verbindung hergestellt ist, hat die KI Zugriff auf die gesamte Suite der PyNet-Tools:

🧠 Der KI zugängliche Kernfunktionen

🔍 System & Verbindung

• list_active_instances: Scannt das System nach laufenden Autodesk-Prozessen mit einer aktiven PyNet-Verbindung.

• check_plugin_status: Handshake-Ping, um zu überprüfen, ob der Plugin-Listener reagiert.

🏗️ Modul- (Tab-) Verwaltung

• get_pynet_ui_layout: Ruft die vollständige UI-Struktur ab (ButtonsModules und ScriptButtons).

• create_pynet_module: Erstellt einen neuen benutzerdefinierten Tab (ButtonsModule) im Ribbon.

• delete_pynet_module: Löscht ein Modul und alle seine Inhalte dauerhaft.

🔘 Schaltflächenverwaltung

• get_buttons_data: Listet alle Skript-Schaltflächen für eine bestimmte Modul-ID auf.

• deploy_script_button: Installiert eine neue ScriptButton in einem bestimmten Modul (Name, Skript, Icon, Tooltip).

• update_script_button: Aktualisiert Metadaten für eine bestehende ScriptButton oder verschiebt sie in ein anderes Modul.

• delete_script_button: Entfernt eine ScriptButton dauerhaft aus einem Modul per ID.

💻 Ausführung & Konsolensteuerung

• send_command: Direkte Skriptausführung in der PyNet-Engine (Ziel-PID, Skriptname, Inhalt).

• get_output_window_status: Überprüft, ob das Ausgabefenster derzeit verfügbar/sichtbar ist.

• configure_output_window: Schaltet die Sichtbarkeit des PyNet-Protokoll-/Ausgabefensters um.

🛡️ Sichere KI-Ausführung

PyNet Bridge enthält eine integrierte Validierungsschicht, die sicherstellt, dass alle KI-generierten Skripte vor der Ausführung sicher und kontrolliert sind.

✔ Verhindert unsichere Operationen ✔ Blockiert unbefugten Systemzugriff ✔ Garantiert kontrollierte Interaktion mit BIM-Modellen

KI bleibt leistungsstark, aber innerhalb sicherer Grenzen

Ab v1.1.1 enthält der MCP-Server einen integrierten statischen Analysator, der jedes Skript validiert, bevor es den Autodesk-Host erreicht. Alle Skripte werden auf Bridge-Ebene geparst und überprüft — abgelehnte Skripte verlassen niemals den MCP-Server.

Zulässige CLR-Assemblies

Nur diese .NET-Referenzen sind über clr.AddReference zulässig:

• Common: System, System.Windows.Forms, System.Drawing, System.Collections.Generic

• Navisworks: Autodesk.Navisworks.Api, .ComApi, .Interop.ComApi, .Clash

• Revit: RevitAPI, RevitAPIUI

• AutoCAD / Civil 3D: AcMgd, AcCoreMgd, AcDbMgd, AecBaseMgd, AecPropDataMgd, AeccDbMgd

• PyNet-Plugins: Raen.Core.Pynet.*, Raen.{Product}.Pynet.* (jede Version — z. B. Raen.Core.Pynet.Resources, Raen.Navisworks.Pynet.2024, Raen.Civil3D.Pynet.2026)

Zulässige Python-Importe

clr, sys, json, re, time, datetime, pathlib, typing, threading, collections, xml, pandas, plotly, matplotlib, dash, webbrowser, psutil, functools

Zulässige Python-Submodule

Einige Module sind nur auf Submodul-Ebene zulässig, um den Zugriff auf gefährliche Geschwister zu verhindern:

Blockierte Python-Importe

os, subprocess, shutil, socket, ctypes, pickle, importlib, urllib, signal, multiprocessing, tempfile, glob, inspect, code, codeop

Blockierte Aufrufe

eval, exec, compile, __import__, getattr, setattr, delattr, globals, locals, vars, breakpoint, open

Blockierter Attributzugriff

__builtins__, __subclasses__, __globals__, __code__

Jedes Skript, das gegen diese Regeln verstößt, wird sofort mit einer beschreibenden Fehlermeldung abgelehnt, ohne jemals an das Plugin gesendet zu werden.

📂 Projektstruktur

• pynet_mcp/: Kern-MCP-Server-Logik (FastMCP).

• pyproject.toml: Paketkonfiguration und Abhängigkeitsverwaltung.

📥 Erste Schritte

Beginnen Sie in wenigen Minuten mit der Erstellung autonomer BIM-Workflows.

Installieren Sie die Bridge, verbinden Sie Ihren KI-Client und verwandeln Sie natürliche Sprache in echte Aktionen innerhalb Ihrer Modelle.

❓ FAQs

Haben Sie Fragen zur Installation, Konfiguration oder Nutzung? Besuchen Sie die vollständige FAQ-Seite:

👉 PyNet FAQs

🔗 Wie dieses MCP in das Ökosystem passt

Dieses MCP ist Teil eines modularen Systems, das darauf ausgelegt ist, KI-gesteuerte BIM-Automatisierung über Autodesk-Tools hinweg zu ermöglichen.

Dieses Repository ist für die Zusammenarbeit mit folgenden Komponenten konzipiert:

• PyNet Platform → Führt Skripte innerhalb von Navisworks, Revit & Civil 3D über Python.NET aus.

• PyNet Library → Gibt der KI Kontext mit einer Bibliothek von Python-Skripten.

Zusammen ermöglichen diese Komponenten:

Natürliche Sprache → KI → Python-Skript → PyNet → Autodesk → BIM-Aktion

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• check_plugin_statusC
• configure_output_windowC
• create_pynet_moduleC
• delete_pynet_moduleC
• delete_script_buttonB
• deploy_script_buttonC
• get_buttons_dataC
• get_output_window_statusC