🐍 PyNet Platform Bridge (MCP)

PyNet Platform Bridge ist ein Model Context Protocol (MCP) Server, der es KI-Modellen (wie Claude, GPT-4o oder Gemini) ermöglicht, direkt über die PyNet-Plattform mit Autodesk-Tools zu interagieren.

Diese Brücke 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 mittels natürlicher Sprache.

🚀 Hauptfunktionen

Dynamische UI-Bereitstellung: Ermöglicht es der KI, benutzerdefinierte Ribbon-Tabs (Module) und Schaltflächen in Navisworks/Revit in Echtzeit zu erstellen.
Skriptausführung: Nahtloses Senden und Ausführen von Python-Code direkt innerhalb der internen Engine der PyNet-Plattform.
Instanzerkennung: Automatische Lokalisierung aktiver Navisworks/Revit-Prozesse mittels PID-Tracking über psutil.
Robuste Kommunikation: Basiert auf Named Pipes für IPC (Inter-Process Communication) mit geringer Latenz und hoher Zuverlässigkeit.
Offenes Ökosystem: Kompatibel mit jedem MCP-Client (Claude Desktop, Cursor, VS Code, Zed, etc.).

🛠️ 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:

Installation von pynet-mcp-bridge über PyPI
Konfiguration von Claude Desktop (unterstützt sowohl Standard- als auch Microsoft Store-Versionen)
Konfiguration von Claude Code (VS Code-Erweiterung)

Starten Sie Claude Desktop und/oder VS Code nach der Installation neu.

Voraussetzungen

PyNet Platform-Plugin in Navisworks/Revit installiert.
Python 3.10 oder höher → python.org

🔧 Option B — Manuelle Installation

1. Installieren Sie das Paket:

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": []
    }
  }
}

🛠️ Verfügbare MCP-Tools

Sobald die Verbindung hergestellt ist, hat die KI Zugriff auf die gesamte Suite der PyNet-Tools:

🔍 System & Verbindung

list_active_instances: Scannt das System nach laufenden Navisworks-Prozessen (roamer.exe) mit einer aktiven PyNet-IPC-Pipe.
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 ein neues benutzerdefiniertes Tab (ButtonsModule) im Ribbon.
delete_pynet_module: Löscht dauerhaft ein Modul und alle seine Inhalte.

🔘 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 dauerhaft eine ScriptButton aus einem Modul anhand ihrer 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 aktuell verfügbar/sichtbar ist.
configure_output_window: Schaltet die Sichtbarkeit des PyNet-Protokoll-/Ausgabefensters um.

📂 Projektstruktur

pynet_mcp/: Kern-MCP-Serverlogik (FastMCP).
pyproject.toml: Paketkonfiguration und Abhängigkeitsverwaltung.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

PyNet Bridge