Skip to main content
Glama
PyNet Bridge

PyNet Bridge

by RAEN-DT

🐍 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: 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 | 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:

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 | iex

Dies 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, 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:

Zulässig

Blockiert

Grund

http.server

http.client, http.cookiejar

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:

👉 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

Komponente

Repository

Zweck

PyNet Platform

rafa2403nunez-droid/PyNet

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

rafa2403nunez-droid/PyNetLibrary

Skript-Referenzbibliothek und KI-Kontext

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.


Available Tools

24 tools
check_plugin_statusB
Read-only

Handshake ping to verify the plugin listener is responsive.

Inputs: pid (required). Returns: result

configure_output_windowC
Destructive

Toggles the visibility of the PyNet log/output window.

Inputs: pid (required), is_available (required). Returns: result

create_pynet_moduleC
Destructive

Creates a new custom Tab (ButtonsModule) in the Ribbon.

Inputs: pid (required), name (required). Returns: result

delete_pynet_moduleC
Destructive

Permanently deletes a module and all its contents.

Inputs: pid (required), module_id (required). Returns: result

delete_script_buttonB
Destructive

Permanently removes a ScriptButton from a module by Id.

Inputs: pid (required), button_id (required), module_id (required). Returns: result

deploy_script_buttonB
Destructive

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_dataA
Read-only

Lists all script buttons for a specific module ID.

Inputs: pid (required), module_id (required). Returns: result

get_output_window_statusB
Read-only

Checks if the output window is currently available/visible.

Inputs: pid (required). Returns: result

get_pynet_ui_layoutC
Read-only

Fetches the full UI structure (ButtonsModules and ScriptButtons).

Inputs: pid (required). Returns: result

list_active_instancesA
Read-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_commandB
Destructive

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_pathA
Destructive

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_buttonB
Destructive

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_clearA
Read-only

Clears highlights and ghosting in the open viewer.

Inputs: no named parameters. Returns: result

viewer_fitA
Read-only

Fits the camera to all models in the open viewer.

Inputs: no named parameters. Returns: result

viewer_get_propertiesA
Read-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_stateA
Read-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_clashA
Destructive

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_isolateA
Destructive

Isolates (hides everything except) the given pnt_ids in the open viewer.

Inputs: pnt_ids. Returns: result

viewer_isolate_modelsA
Destructive

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_clashesA
Read-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_packageB
Destructive

Loads a .pnt into the open viewer and returns a summary read from clashes.json.

Inputs: pnt_path (required). Returns: result

viewer_selectA
Destructive

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_statusA
Read-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

    B3.3/5.0

    Scored across 24 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers