PyNet Bridge
🐍 PyNet 플랫폼 브리지 (MCP)
**PyNet 플랫폼 브리지 (MCP)**는 AI 모델이 Autodesk 도구를 실시간으로 제어할 수 있게 해주는 실행 계층입니다.
자연어 → Python → Autodesk 데스크톱 도구(Navisworks, Revit, AutoCAD)를 연결하여 AI가 BIM 워크플로우를 자율적으로 생성, 실행 및 개선할 수 있도록 합니다.
Navisworks Manage, Revit, AutoCAD 통합을 지원합니다.
이 브리지는 AI 로직과 Autodesk 데스크톱 API 사이의 연결 고리 역할을 하며, 자연어를 사용하여 동적 UI 생성, 스크립트 실행 및 BIM 프로세스 자동화를 가능하게 합니다.
🔄 작동 방식
사용자가 자연어로 작업을 설명합니다.
AI가 Python 스크립트를 생성합니다.
PyNet Bridge가 스크립트를 검증하고 전송합니다.
PyNet 플러그인이 Autodesk 내부에서 이를 실행합니다.
결과가 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이 작업은 자동으로 다음을 수행합니다:
Python 3.10+ 설치 여부 확인
PyPI에서
pynet-mcp-bridge설치 (uv또는pip사용)설치된 모든 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-bridge2. Claude Desktop 구성:
claude_desktop_config.json에 다음을 추가하세요:
표준:
%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. 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.GenericNavisworks:
Autodesk.Navisworks.Api,.ComApi,.Interop.ComApi,.ClashRevit:
RevitAPI,RevitAPIUIAutoCAD / Civil 3D:
AcMgd,AcCoreMgd,AcDbMgd,AecBaseMgd,AecPropDataMgd,AeccDbMgdPyNet 플러그인:
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 서빙 허용, 아웃바운드 요청 차단 |
차단된 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 페이지를 확인하세요:
🔗 이 MCP가 생태계에 적합한 방식
이 MCP는 Autodesk 도구 전반에 걸쳐 AI 기반 BIM 자동화를 가능하게 하도록 설계된 모듈형 시스템의 일부입니다.
이 저장소는 다음 도구와 함께 작동하도록 설계되었습니다:
PyNet 플랫폼 → Python.NET을 통해 Navisworks, Revit 및 Civil 3D 내에서 스크립트를 실행합니다.
PyNet 라이브러리 → Python 스크립트 라이브러리로 AI에게 컨텍스트를 제공합니다.
이 구성 요소들은 함께 다음을 가능하게 합니다:
자연어 → AI → Python 스크립트 → PyNet → Autodesk → BIM 작업
구성 요소 | 저장소 | 목적 |
PyNet 플랫폼 | Navisworks, Revit 및 Civil 3D 플러그인 — Python.NET 엔진 호스팅 | |
PyNet 브리지 (MCP) | 이 저장소 | MCP 서버 - 안전한 스크립트 검증을 포함하여 AI 모델을 PyNET에 연결 |
PyNet 라이브러리 | 스크립트 참조 라이브러리 및 AI 컨텍스트 |
📄 라이선스
이 프로젝트는 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