Skip to main content
Glama
PyNet Bridge

PyNet Bridge

by RAEN-DT

🐍 PyNet 플랫폼 브리지 (MCP)

**PyNet 플랫폼 브리지 (MCP)**는 AI 모델이 Autodesk 도구를 실시간으로 제어할 수 있게 해주는 실행 계층입니다.

자연어 → Python → Autodesk 데스크톱 도구(Navisworks, Revit, AutoCAD)를 연결하여 AI가 BIM 워크플로우를 자율적으로 생성, 실행 및 개선할 수 있도록 합니다.

Navisworks Manage, Revit, AutoCAD 통합을 지원합니다.

이 브리지는 AI 로직과 Autodesk 데스크톱 API 사이의 연결 고리 역할을 하며, 자연어를 사용하여 동적 UI 생성, 스크립트 실행 및 BIM 프로세스 자동화를 가능하게 합니다.

🔄 작동 방식

  1. 사용자가 자연어로 작업을 설명합니다.

  2. AI가 Python 스크립트를 생성합니다.

  3. PyNet Bridge가 스크립트를 검증하고 전송합니다.

  4. PyNet 플러그인이 Autodesk 내부에서 이를 실행합니다.

  5. 결과가 AI에게 반환됩니다.

이것이 바로 AI를 단순한 챗봇에서 BIM을 위한 실행 엔진으로 변화시키는 핵심입니다.


Related MCP server: A2A MCP Server

🚀 PyNet Bridge의 강력한 기능

  • AI → 작업: AI가 생성한 코드를 Navisworks/Revit 내의 실제 작업으로 변환

  • 실시간 실행: BIM 환경을 벗어나지 않고 즉시 스크립트 실행

  • 동적 UI 생성: AI가 즉석에서 도구, 버튼 및 워크플로우를 생성하도록 허용

  • 안정적인 통신: 빠르고 안정적인 로컬 IPC

  • 모델 인식 자동화: 라이브 BIM 모델에서 직접 작동


🛠️ 설치

✅ 옵션 A — 자동 설치 프로그램 (권장)

PowerShell을 열고 다음을 실행하세요:

irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install.ps1 | iex

이 작업은 자동으로 다음을 수행합니다:

  1. Python 3.10+ 설치 여부 확인

  2. PyPI에서 pynet-mcp-bridge 설치 (uv 또는 pip 사용)

  3. 설치된 모든 AI 클라이언트 자동 감지 및 구성:

    • Claude Desktop (표준 및 Microsoft Store 버전)

    • Claude Code (VS Code 확장 프로그램 / CLI)

    • Cline (VS Code 확장 프로그램)

    • Roo Code (VS Code 확장 프로그램)

pynet-mcp-bridge 패키지 구성:

패키지

목적

pynet-mcp-bridge

AI 모델과 Autodesk Navisworks를 PyNET을 통해 연결하는 MCP 서버

mcp[cli]

Model Context Protocol SDK 및 CLI 도구

fastmcp

고수준 MCP 서버 프레임워크

psutil

시스템 프로세스 감지 (실행 중인 Autodesk 인스턴스 찾기)

설치 후 변경 사항을 적용하려면 AI 클라이언트를 다시 시작하세요.

📦 Python 라이브러리 스타터 팩 (선택 사항)

PyNET을 사용한 Navisworks/Revit 스크립팅을 위해 권장되는 Python 라이브러리를 설치하세요:

irm https://raw.githubusercontent.com/rafa2403nunez-droid/PyNetBridge/main/install-libraries.ps1 | iex

설치되는 항목:

라이브러리

목적

pandas

데이터 분석 및 조작

plotly

대화형 차트 및 시각화

matplotlib

정적 플롯 및 그래프

dash

Python 기반 웹 대시보드

이 라이브러리들은 허용된 Python 임포트에 나열된 타사 라이브러리입니다. 표준 라이브러리 모듈(json, sys, re 등)은 Python에 이미 포함되어 있습니다.

필수 조건

  • Navisworks/Revit에 PyNet 플랫폼 플러그인 설치.

  • Python 3.10 이상 → python.org

    ⚠️ Python 3.14는 아직 지원되지 않습니다. pythonnet 런타임은 현재 Python 3.7부터 3.13까지 지원합니다. 지원되지 않는 ABI 버전을 언급하는 System.NotSupportedException이 발생하면 Python 3.12 또는 3.13을 설치하고 PyNet이 이를 사용하도록 구성하세요.

  • uv → docs.astral.sh/uv

  • Git → git-scm.com — VS Code 확장 프로그램(Claude Code, Cline, Roo Code)이 올바르게 작동하기 위해 필요합니다.

  • Cline / Roo Code 사용 시: VS Code → code.visualstudio.com


🔧 옵션 B — 수동 설치

1. 패키지 설치:

uv tool install pynet-mcp-bridge

또는 pip 사용:

pip install pynet-mcp-bridge

2. Claude Desktop 구성:

claude_desktop_config.json에 다음을 추가하세요:

  • 표준: %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. Claude Code (VS Code 확장 프로그램) 구성:

%USERPROFILE%\.claude.json에 추가하세요:

{
  "mcpServers": {
    "pynet-bridge": {
      "type": "stdio",
      "command": "pynet-bridge",
      "args": []
    }
  }
}

4. Cline 구성:

%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json에 추가하세요:

{
  "mcpServers": {
    "pynet-bridge": {
      "type": "stdio",
      "command": "pynet-bridge",
      "args": []
    }
  }
}

5. Roo Code 구성:

%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json에 추가하세요:

{
  "mcpServers": {
    "pynet-bridge": {
      "type": "stdio",
      "command": "pynet-bridge",
      "args": []
    }
  }
}

🛠️ 사용 가능한 MCP 도구

이 도구들은 AI가 UI 생성부터 스크립트 실행 및 시스템 모니터링에 이르기까지 PyNet 환경을 완전히 제어할 수 있게 합니다. 연결되면 AI는 전체 PyNet 도구 모음에 액세스할 수 있습니다:

🧠 AI에게 노출된 핵심 기능

🔍 시스템 및 연결

  • list_active_instances: 활성 PyNet 연결이 있는 실행 중인 Autodesk 프로세스를 시스템에서 검색합니다.

  • check_plugin_status: 플러그인 리스너가 응답하는지 확인하기 위한 핸드셰이크 핑입니다.

🏗️ 모듈 (탭) 관리

  • get_pynet_ui_layout: 전체 UI 구조(ButtonsModules 및 ScriptButtons)를 가져옵니다.

  • create_pynet_module: 리본에 새로운 사용자 지정 탭(ButtonsModule)을 생성합니다.

  • delete_pynet_module: 모듈과 그 안의 모든 내용을 영구적으로 삭제합니다.

🔘 버튼 관리

  • get_buttons_data: 특정 모듈 ID에 대한 모든 스크립트 버튼을 나열합니다.

  • deploy_script_button: 특정 모듈에 새로운 ScriptButton을 설치합니다(이름, 스크립트, 아이콘, 툴팁).

  • update_script_button: 기존 ScriptButton의 메타데이터를 업데이트하거나 다른 모듈로 이동합니다.

  • delete_script_button: ID를 사용하여 모듈에서 ScriptButton을 영구적으로 제거합니다.

💻 실행 및 콘솔 제어

  • send_command: PyNet 엔진에서 직접 스크립트를 실행합니다(대상 PID, 스크립트 이름, 내용).

  • get_output_window_status: 출력 창을 현재 사용할 수 있는지/표시되는지 확인합니다.

  • configure_output_window: PyNet 로그/출력 창의 표시 여부를 전환합니다.


🛡️ 안전한 AI 실행

PyNet Bridge에는 AI가 생성한 모든 스크립트가 실행 전에 안전하고 제어된 상태인지 확인하는 내장 검증 계층이 포함되어 있습니다.

✔ 안전하지 않은 작업 방지 ✔ 승인되지 않은 시스템 액세스 차단 ✔ BIM 모델과의 제어된 상호 작용 보장

AI는 강력함을 유지하되, 안전한 경계 내에서 작동합니다.

v1.1.1부터 MCP 서버에는 Autodesk 호스트에 도달하기 전에 모든 스크립트를 검증하는 내장 정적 분석기가 포함되어 있습니다. 모든 스크립트는 브리지 수준에서 구문 분석 및 검사되며, 거부된 스크립트는 MCP 서버를 절대 떠나지 않습니다.

허용된 CLR 어셈블리

clr.AddReference를 통해 다음 .NET 참조만 허용됩니다:

  • 공통: 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 플러그인: Raen.Core.Pynet.*, Raen.{Product}.Pynet.* (모든 버전 — 예: Raen.Core.Pynet.Resources, Raen.Navisworks.Pynet.2024, Raen.Civil3D.Pynet.2026)

허용된 Python 임포트

clr, sys, json, re, time, datetime, pathlib, typing, threading, collections, xml, pandas, plotly, matplotlib, dash, webbrowser, psutil, functools

허용된 Python 하위 모듈

일부 모듈은 하위 모듈 수준에서만 허용되어 위험한 요소에 대한 액세스를 방지합니다:

허용됨

차단됨

이유

http.server

http.client, http.cookiejar

로컬 HTTP 서빙 허용, 아웃바운드 요청 차단

차단된 Python 임포트

os, subprocess, shutil, socket, ctypes, pickle, importlib, urllib, signal, multiprocessing, tempfile, glob, inspect, code, codeop

차단된 호출

eval, exec, compile, __import__, getattr, setattr, delattr, globals, locals, vars, breakpoint, open

차단된 속성 액세스

__builtins__, __subclasses__, __globals__, __code__

이 규칙을 위반하는 모든 스크립트는 플러그인으로 전송되지 않고 즉시 설명 오류 메시지와 함께 거부됩니다.


📂 프로젝트 구조

  • pynet_mcp/: 핵심 MCP 서버 로직 (FastMCP).

  • pyproject.toml: 패키지 구성 및 종속성 관리.


📥 시작하기

몇 분 안에 자율적인 BIM 워크플로우 구축을 시작하세요.

브리지를 설치하고, AI 클라이언트를 연결하고, 자연어를 모델 내의 실제 작업으로 변환하세요.


❓ 자주 묻는 질문 (FAQ)

설치, 구성 또는 사용에 대해 궁금한 점이 있으신가요? 전체 FAQ 페이지를 확인하세요:

👉 PyNet FAQ


🔗 이 MCP가 생태계에 적합한 방식

이 MCP는 Autodesk 도구 전반에 걸쳐 AI 기반 BIM 자동화를 가능하게 하도록 설계된 모듈형 시스템의 일부입니다.

이 저장소는 다음 도구와 함께 작동하도록 설계되었습니다:

  • PyNet 플랫폼 → Python.NET을 통해 Navisworks, Revit 및 Civil 3D 내에서 스크립트를 실행합니다.

  • PyNet 라이브러리 → Python 스크립트 라이브러리로 AI에게 컨텍스트를 제공합니다.

이 구성 요소들은 함께 다음을 가능하게 합니다:

자연어 → AI → Python 스크립트 → PyNet → Autodesk → BIM 작업

구성 요소

저장소

목적

PyNet 플랫폼

rafa2403nunez-droid/PyNet

Navisworks, Revit 및 Civil 3D 플러그인 — Python.NET 엔진 호스팅

PyNet 브리지 (MCP)

이 저장소

MCP 서버 - 안전한 스크립트 검증을 포함하여 AI 모델을 PyNET에 연결

PyNet 라이브러리

rafa2403nunez-droid/PyNetLibrary

스크립트 참조 라이브러리 및 AI 컨텍스트

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.


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