PyNet Bridge
🐍 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
Der Benutzer beschreibt eine Aufgabe in natürlicher Sprache.
Die KI generiert ein Python-Skript.
PyNet Bridge validiert und sendet das Skript.
Das PyNet-Plugin führt es innerhalb von Autodesk aus.
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: A2A 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 | iexDies führt automatisch folgende Schritte aus:
Überprüfung, ob Python 3.10+ installiert ist
Installation von
pynet-mcp-bridgevon PyPI (viauvoderpip)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:
Paket | Zweck |
pynet-mcp-bridge | MCP-Server, der KI-Modelle mit Autodesk Navisworks über PyNET verbindet |
mcp[cli] | Model Context Protocol SDK und CLI-Tools |
fastmcp | High-Level MCP-Server-Framework |
psutil | Systemprozesserkennung (findet laufende Autodesk-Instanzen) |
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 | iexDies installiert:
Bibliothek | Zweck |
pandas | Datenanalyse und -manipulation |
plotly | Interaktive Diagramme und Visualisierungen |
matplotlib | Statische Diagramme und Grafiken |
dash | Web-Dashboards aus Python |
Dies sind die Drittanbieter-Bibliotheken, die unter Allowed Python Imports aufgeführt sind. Standard-Bibliotheksmodule (
json,sys,reusw.) 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 eineSystem.NotSupportedExceptionstoß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-bridgeOder mit pip:
pip install pynet-mcp-bridge2. Konfigurieren Sie Claude Desktop:
Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:
Standard:
%APPDATA%\Claude\claude_desktop_config.jsonMicrosoft 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.GenericNavisworks:
Autodesk.Navisworks.Api,.ComApi,.Interop.ComApi,.ClashRevit:
RevitAPI,RevitAPIUIAutoCAD / Civil 3D:
AcMgd,AcCoreMgd,AcDbMgd,AecBaseMgd,AecPropDataMgd,AeccDbMgdPyNet-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:
Zulässig | Blockiert | Grund |
|
| Lokales HTTP-Serving erlauben, ausgehende Anfragen blockieren |
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:
🔗 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
Komponente | Repository | Zweck |
PyNet Platform | Navisworks, Revit & Civil 3D Plugin — hostet die Python.NET-Engine | |
PyNet Bridge (MCP) | Dieses Repo | MCP-Server - verbindet KI-Modelle mit PyNET inklusive sicherer Skriptvalidierung |
PyNet Library | Skript-Referenzbibliothek und KI-Kontext |
📄 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert.
Available Tools
24 toolscheck_plugin_statusBRead-only
Handshake ping to verify the plugin listener is responsive.
Inputs: pid (required). Returns: result
configure_output_windowCDestructive
Toggles the visibility of the PyNet log/output window.
Inputs: pid (required), is_available (required). Returns: result
create_pynet_moduleCDestructive
Creates a new custom Tab (ButtonsModule) in the Ribbon.
Inputs: pid (required), name (required). Returns: result
delete_pynet_moduleCDestructive
Permanently deletes a module and all its contents.
Inputs: pid (required), module_id (required). Returns: result
delete_script_buttonBDestructive
Permanently removes a ScriptButton from a module by Id.
Inputs: pid (required), button_id (required), module_id (required). Returns: result
deploy_script_buttonBDestructive
Installs a new ScriptButton into a specific module (Name, Script, Icon, Tooltip).
Inputs: pid (required), name (required), module_id (required), script_Path (required), +2 more. Returns: result
get_buttons_dataARead-only
Lists all script buttons for a specific module ID.
Inputs: pid (required), module_id (required). Returns: result
get_output_window_statusBRead-only
Checks if the output window is currently available/visible.
Inputs: pid (required). Returns: result
get_pynet_ui_layoutCRead-only
Fetches the full UI structure (ButtonsModules and ScriptButtons).
Inputs: pid (required). Returns: result
list_active_instancesARead-only
Scans the system for running host processes (Autodesk, Rhino, AVEVA UE, PyNET for Tekla/Presto) with an active PyNet IPC pipe.
Inputs: no named parameters. Returns: result
send_commandBDestructive
Direct script execution in the PyNet engine (Target PID, Script Name, Content).
Inputs: pid (required), content (required), timeout (required), script_name (required). Returns: result
send_command_by_pathADestructive
Executes a script file directly by path in the PyNet engine, without sending content inline.
Inputs: pid (required), timeout (required), file_path (required), script_name (required). Returns: result
update_script_buttonBDestructive
Updates metadata for an existing ScriptButton or moves it to another module.
Inputs: pid (required), name (required), tooltip (required), button_id (required), +4 more. Returns: result
viewer_clearARead-only
Clears highlights and ghosting in the open viewer.
Inputs: no named parameters. Returns: result
viewer_fitARead-only
Fits the camera to all models in the open viewer.
Inputs: no named parameters. Returns: result
viewer_get_propertiesARead-only
Reads element properties (name, model, psets) from the loaded package's properties.json.
Pass one or more pnt_ids to get their full properties (including psets) directly.
Called with no pnt_ids, returns a paginated lightweight index (pnt_id, name, model) instead
of every element — narrow it with model (exact model/discipline name, e.g. "Snowdon Towers
Sample HVAC") and/or search (case-insensitive substring of the element name), and page
through with limit/offset (default 200 per page, capped at 500). On a federated model
the unfiltered index can have tens of thousands of entries — always pass model or search
when you can, and use offset to page through the rest.
The data source is the .pnt's properties.json, NOT the viewer or IFC.
Inputs: limit, model, offset, search, +1 more. Returns: result
viewer_get_stateARead-only
Reads the viewer's last reported state: loaded models and the pnt_id of whatever the user currently has selected (click in the 3D view or the tree panel — null if nothing is selected). Use the returned pnt_id with viewer_get_properties for its details, or feed it into a clashes.json lookup to find what it clashes with.
Inputs: no named parameters. Returns: result
viewer_highlight_clashADestructive
Highlights a clash (element(s) A red, element(s) B green) and isolates the rest away.
Usually one pnt_id per side (a single clash pair), but either side accepts a list — e.g. one element (A) against every counterpart it clashes with (B), all shown at once.
Inputs: pnt_id_a, pnt_id_b. Returns: result
viewer_isolateADestructive
Isolates (hides everything except) the given pnt_ids in the open viewer.
Inputs: pnt_ids. Returns: result
viewer_isolate_modelsADestructive
Shows only the given model(s)/discipline(s) (by exact name, e.g. "Snowdon Towers Sample HVAC"), hiding every other loaded model. Cheaper than viewer_isolate for "just show me this discipline" requests — no need to resolve every element's pnt_id first. Get the exact model names from viewer_get_state's "models" list. Undo with viewer_clear.
Inputs: models. Returns: result
viewer_list_clashesARead-only
Reads the loaded package's clashes.json — the data source, NOT the viewer/IFC.
Returns each clash with the pnt_id identifiers needed to highlight it.
Inputs: no named parameters. Returns: result
viewer_load_packageBDestructive
Loads a .pnt into the open viewer and returns a summary read from clashes.json.
Inputs: pnt_path (required). Returns: result
viewer_selectADestructive
Highlights a set of elements in the open viewer by pnt_id, in neutral colours (yellow / blue) with nothing else hidden — a plain "look at these" pointer.
Pass a list of pnt_ids in pnt_ids (group A). Optionally pass a second list in
pnt_ids_b to highlight a second group in a distinct colour. Replaces any previous
selection. Use viewer_list_clashes / viewer_get_properties to obtain pnt_ids.
For a clash pair (red/green, with the rest of the model isolated away), use
viewer_highlight_clash instead.
Inputs: pnt_ids, pnt_ids_b. Returns: result
viewer_statusARead-only
Reports whether a PyNet BIM Viewer is open in VS Code (port, package, data dir).
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
The viewer tools have the most potential for confusion (select vs highlight_clash vs isolate vs isolate_models vs clear), but the descriptions explicitly cross-reference each other and state when to prefer one over another, which resolves most of it. A few boundaries remain soft — check_plugin_status vs list_active_instances vs viewer_status all report 'is something alive', and configure_output_window vs get_output_window_status are near-mirror pairs — but they are separable.
Nearly everything follows verb_noun (get_, create_, delete_, update_, deploy_, list_, send_, configure_, check_), with a clean viewer_ namespace for the 3D side. Minor deviations: the ribbon/button noun is inconsistent ('buttons' in get_buttons_data vs 'script_button' in deploy/update/delete_script_button, and get_pynet_ui_layout is a noun-first outlier), and some tools carry a domain prefix while others do not.
24 tools is on the heavy side, and the surface spans four separate concerns (viewer control, ribbon/module management, IPC process discovery, script execution). The count is defensible given the breadth of the PyNet bridge, but a few low-value entries (viewer_fit, get_output_window_status) could be folded into neighbours.
Script buttons have full CRUD (deploy/update/delete/get_buttons_data), the viewer has load/state/properties/select/isolate/highlight/clear/fit, and execution has both inline and by-path variants. The main gap is module lifecycle: create_pynet_module and delete_pynet_module exist but there is no update/rename/reorder module tool, and there is no way to unload a package or detach from a running instance.
Maintenance
Related MCP Connectors
A2a Governance Bridge MCP Server by MEOK AI Labs
MCP federation gateway: route, govern and observe agent tools across clouds and MCP servers.
MCP Server for an Agent Task Marketplace
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceControl AI agents creation and modification via MCP.-
- AlicenseAqualityFmaintenanceA bridge server that enables MCP-compatible AI assistants like Claude to seamlessly discover, communicate with, and manage A2A protocol agents.7113 PyPI146Apache 2.0
- AlicenseBqualityFmaintenanceA bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.1665 PyPI24MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for cross-platform agent onboarding. Registers external agents, translates intents from LangChain, CrewAI, AutoGen, and A2A formats, and proxies cross-ecosystem transactions.MIT