PyNet Bridge
🐍 PyNet Platform Bridge (MCP)
PyNet Platform Bridge (MCP) es la capa de ejecución que permite a los modelos de IA controlar herramientas de Autodesk en tiempo real.
Conecta Lenguaje Natural → Python → Herramientas de escritorio de Autodesk (Navisworks, Revit, AutoCAD), permitiendo que la IA genere, ejecute y refine flujos de trabajo BIM de forma autónoma.
Las integraciones disponibles incluyen Navisworks Manage, Revit y AutoCAD.
Este puente actúa como el tejido conectivo entre la lógica de la IA y las APIs de escritorio de Autodesk, permitiendo la creación dinámica de interfaces de usuario, la ejecución de scripts y la automatización de procesos BIM mediante lenguaje natural.
🔄 Cómo funciona
El usuario describe una tarea en lenguaje natural.
La IA genera un script de Python.
PyNet Bridge valida y envía el script.
El plugin de PyNet lo ejecuta dentro de Autodesk.
Los resultados se devuelven a la IA.
Esto es lo que convierte a la IA de un chatbot en un motor de ejecución para BIM.
Related MCP server: A2A MCP Server
🚀 Qué hace potente a PyNet Bridge
IA → Acción: Convierte código generado por IA en acciones reales dentro de Navisworks/Revit
Ejecución en tiempo real: Ejecuta scripts al instante sin salir del entorno BIM
Creación dinámica de UI: Permite que la IA cree herramientas, botones y flujos de trabajo sobre la marcha
Comunicación fiable: IPC local rápido y estable
Automatización consciente del modelo: Opera directamente sobre modelos BIM en vivo
🛠️ Instalación
✅ Opción A — Instalador automático (recomendado)
Abra PowerShell y ejecute:
irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install.ps1 | iexEsto hará automáticamente lo siguiente:
Comprobará que Python 3.10+ esté instalado
Instalará
pynet-mcp-bridgedesde PyPI (víauvopip)Detectará y configurará automáticamente todos los clientes de IA instalados:
Claude Desktop (versiones estándar y de Microsoft Store)
Claude Code (extensión de VS Code / CLI)
Cline (extensión de VS Code)
Roo Code (extensión de VS Code)
El paquete pynet-mcp-bridge incluye:
Paquete | Propósito |
pynet-mcp-bridge | Servidor MCP que conecta modelos de IA con Autodesk Navisworks vía PyNET |
mcp[cli] | SDK del Protocolo de Contexto de Modelo y herramientas CLI |
fastmcp | Framework de servidor MCP de alto nivel |
psutil | Detección de procesos del sistema (encuentra instancias de Autodesk en ejecución) |
Reinicie su(s) cliente(s) de IA después de la instalación para aplicar los cambios.
📦 Paquete de inicio de librerías de Python (opcional)
Instale las librerías de Python recomendadas para scripting en Navisworks/Revit con PyNET:
irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install-libraries.ps1 | iexEsto instala:
Librería | Propósito |
pandas | Análisis y manipulación de datos |
plotly | Gráficos y visualizaciones interactivas |
matplotlib | Gráficos y diagramas estáticos |
dash | Dashboards web desde Python |
Estas son las librerías de terceros listadas en Importaciones de Python permitidas. Los módulos de la librería estándar (
json,sys,re, etc.) ya están incluidos con Python.
Requisitos previos
Plugin PyNet Platform instalado en Navisworks/Revit.
Python 3.10 o superior → python.org
⚠️ Python 3.14 aún no es compatible. El runtime
pythonnetactualmente admite Python 3.7 hasta 3.13. Si encuentra unaSystem.NotSupportedExceptionmencionando una versión ABI no compatible, instale Python 3.12 o 3.13 y configure PyNet para usarla.uv → docs.astral.sh/uv
Git → git-scm.com — requerido para que las extensiones de VS Code (Claude Code, Cline, Roo Code) funcionen correctamente.
Para Cline / Roo Code: VS Code → code.visualstudio.com
🔧 Opción B — Instalación manual
1. Instale el paquete:
uv tool install pynet-mcp-bridgeO con pip:
pip install pynet-mcp-bridge2. Configure Claude Desktop:
Añada lo siguiente a su claude_desktop_config.json:
Estándar:
%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. Configure Claude Code (extensión de VS Code):
Añada a %USERPROFILE%\.claude.json:
{
"mcpServers": {
"pynet-bridge": {
"type": "stdio",
"command": "pynet-bridge",
"args": []
}
}
}4. Configure Cline:
Añada a %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json:
{
"mcpServers": {
"pynet-bridge": {
"type": "stdio",
"command": "pynet-bridge",
"args": []
}
}
}5. Configure Roo Code:
Añada a %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json:
{
"mcpServers": {
"pynet-bridge": {
"type": "stdio",
"command": "pynet-bridge",
"args": []
}
}
}🛠️ Herramientas MCP disponibles
Estas herramientas permiten a la IA controlar completamente el entorno PyNet, desde la creación de UI hasta la ejecución de scripts y la monitorización del sistema. Una vez conectado, la IA tendrá acceso a la suite completa de herramientas de PyNet:
🧠 Capacidades principales expuestas a la IA
🔍 Sistema y Conexión
list_active_instances: Escanea el sistema en busca de procesos de Autodesk en ejecución con una conexión PyNet activa.
check_plugin_status: Ping de saludo para verificar que el listener del plugin responde.
🏗️ Gestión de Módulos (Pestañas)
get_pynet_ui_layout: Obtiene la estructura completa de la UI (ButtonsModules y ScriptButtons).
create_pynet_module: Crea una nueva pestaña personalizada (ButtonsModule) en la cinta de opciones (Ribbon).
delete_pynet_module: Elimina permanentemente un módulo y todo su contenido.
🔘 Gestión de Botones
get_buttons_data: Lista todos los botones de script para un ID de módulo específico.
deploy_script_button: Instala un nuevo ScriptButton en un módulo específico (Nombre, Script, Icono, Tooltip).
update_script_button: Actualiza los metadatos de un ScriptButton existente o lo mueve a otro módulo.
delete_script_button: Elimina permanentemente un ScriptButton de un módulo por su Id.
💻 Ejecución y Control de Consola
send_command: Ejecución directa de scripts en el motor PyNet (PID de destino, Nombre del script, Contenido).
get_output_window_status: Comprueba si la ventana de salida está disponible/visible actualmente.
configure_output_window: Alterna la visibilidad de la ventana de registro/salida de PyNet.
🛡️ Ejecución segura de IA
PyNet Bridge incluye una capa de validación integrada que garantiza que todos los scripts generados por IA sean seguros y controlados antes de su ejecución.
✔ Previene operaciones inseguras ✔ Bloquea el acceso no autorizado al sistema ✔ Garantiza una interacción controlada con modelos BIM
La IA sigue siendo potente, pero dentro de límites seguros
A partir de la v1.1.1, el servidor MCP incluye un analizador estático integrado que valida cada script antes de que llegue al host de Autodesk. Todos los scripts son analizados e inspeccionados a nivel de puente — los scripts rechazados nunca salen del servidor MCP.
Ensamblados CLR permitidos
Solo se permiten estas referencias de .NET vía clr.AddReference:
Común:
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,AeccDbMgdPlugins de PyNet:
Raen.Core.Pynet.*,Raen.{Product}.Pynet.*(cualquier versión — ej.Raen.Core.Pynet.Resources,Raen.Navisworks.Pynet.2024,Raen.Civil3D.Pynet.2026)
Importaciones de Python permitidas
clr, sys, json, re, time, datetime, pathlib, typing, threading, collections, xml, pandas, plotly, matplotlib, dash, webbrowser, psutil, functools
Submódulos de Python permitidos
Algunos módulos solo se permiten a nivel de submódulo, evitando el acceso a elementos hermanos peligrosos:
Permitido | Bloqueado | Razón |
|
| Permitir servicio HTTP local, bloquear peticiones salientes |
Importaciones de Python bloqueadas
os, subprocess, shutil, socket, ctypes, pickle, importlib, urllib, signal, multiprocessing, tempfile, glob, inspect, code, codeop
Llamadas bloqueadas
eval, exec, compile, __import__, getattr, setattr, delattr, globals, locals, vars, breakpoint, open
Acceso a atributos bloqueado
__builtins__, __subclasses__, __globals__, __code__
Cualquier script que viole estas reglas es rechazado inmediatamente con un mensaje de error descriptivo, sin llegar nunca a enviarse al plugin.
📂 Estructura del proyecto
pynet_mcp/: Lógica central del servidor MCP (FastMCP).
pyproject.toml: Configuración del paquete y gestión de dependencias.
📥 Primeros pasos
Empiece a construir flujos de trabajo BIM autónomos en minutos.
Instale el puente, conecte su cliente de IA y convierta el lenguaje natural en acciones reales dentro de sus modelos.
❓ Preguntas frecuentes
¿Tiene preguntas sobre la instalación, configuración o uso? Consulte la página completa de preguntas frecuentes:
🔗 Cómo encaja este MCP en el ecosistema
Este MCP es parte de un sistema modular diseñado para permitir la automatización BIM impulsada por IA en las herramientas de Autodesk.
Este repositorio está diseñado para trabajar junto con:
PyNet Platform → Ejecuta scripts dentro de Navisworks, Revit y Civil 3D vía Python.NET
PyNet Library → Proporciona a la IA contexto con una librería de scripts de Python
Juntos, estos componentes permiten:
Lenguaje Natural → IA → Script de Python → PyNet → Autodesk → Acción BIM
Componente | Repositorio | Propósito |
PyNet Platform | Plugin de Navisworks, Revit y Civil 3D — aloja el motor Python.NET | |
PyNet Bridge (MCP) | Este repositorio | Servidor MCP - conecta modelos de IA a PyNET incluyendo validación segura de scripts |
PyNet Library | Librería de referencia de scripts y contexto para la IA |
📄 Licencia
Este proyecto está bajo la Licencia MIT.
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