🐍 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

1. El usuario describe una tarea en lenguaje natural.

2. La IA genera un script de Python.

3. PyNet Bridge valida y envía el script.

4. El plugin de PyNet lo ejecuta dentro de Autodesk.

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

Esto hará automáticamente lo siguiente:

1. Comprobará que Python 3.10+ esté instalado

2. Instalará pynet-mcp-bridge desde PyPI (vía uv o pip)

3. 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:

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

Esto instala:

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 pythonnet actualmente admite Python 3.7 hasta 3.13. Si encuentra una System.NotSupportedException mencionando 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-bridge

O con pip:

pip install pynet-mcp-bridge

2. Configure Claude Desktop:

Añada lo siguiente a su claude_desktop_config.json:

• Estándar: %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. 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.Generic

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

• Revit: RevitAPI, RevitAPIUI

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

• Plugins 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:

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:

👉 PyNet FAQs

🔗 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

📄 Licencia

Este proyecto está bajo la Licencia MIT.

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