🐍 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: ACP-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 패키지 구성:

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

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

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

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

설치되는 항목:

이 라이브러리들은 허용된 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 하위 모듈

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

차단된 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 작업

📄 라이선스

이 프로젝트는 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