Automatización MCP — Navisworks Manage 2025

Servidor Model Context Protocol que permite controlar Autodesk Navisworks Manage 2025 desde Claude en lenguaje natural: inspección de modelos federados, árbol del modelo, búsqueda por propiedades, selection sets y detección de conflictos (clash).

Arquitectura

Claude
   ↕ stdio (MCP)
server.py                      ← FastMCP, define los @mcp.tool()
   └─ tools/plugin_bridge.py       ← cliente TCP → localhost:65433
                                        ↓
      plugin/Navisworks_MCP_Plugin.dll  ← plugin C# DENTRO de Navisworks
                                        ↓ API .NET de Navisworks
                                   Navisworks Manage 2025

Diferencia clave con Civil 3D: Navisworks no expone COM accesible desde Python. El plugin C# es el único camino — si no está cargado, las herramientas devuelven error. Verifica siempre con navis_ping() antes de ejecutar comandos.

Estructura

server.py                  ← servidor MCP (punto de entrada)
app.py                     ← aplicación auxiliar
requirements.txt           ← dependencias Python
tools/                     ← model_info, model_tree, property_search, selection_sets, clash, federated_inspector
bim_tools/                 ← utilidades BIM (property_search)
plugin/                    ← plugin C# (Navisworks_MCP_Plugin.cs) + botones + bundle
instalar_plugin.bat        ← instalación del bundle

Instalación

Servidor MCP

pip install -r requirements.txt
python server.py

Plugin C# (necesario)

cd plugin
dotnet build -c Release

Instala el bundle (auto-carga al abrir Navisworks) copiando plugin/bundle/ a %AppData%\Autodesk\ApplicationPlugins\Navisworks_MCP_Plugin.bundle\ (o usa instalar_plugin.bat). También se puede cargar manualmente en Add-Ins → External → "MCP Server".

Probar la conexión

import socket, json
s = socket.socket(); s.connect(('127.0.0.1', 65433))
s.sendall(json.dumps({'command':'PING','params':{}}).encode())
print(s.recv(4096).decode()); s.close()

Licencia

Ver LICENSE. Autodesk y Navisworks son marcas de Autodesk, Inc. Proyecto no afiliado a Autodesk.