🐍 PyNet 플랫폼 브리지 (MCP)

PyNet 플랫폼 브리지는 AI 모델(Claude, GPT-4o, Gemini 등)이 PyNet 플랫폼을 통해 Autodesk 도구와 직접 상호작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

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

🚀 주요 기능

동적 UI 배포: AI가 Navisworks/Revit에서 사용자 지정 리본 탭(모듈)과 버튼을 실시간으로 생성할 수 있습니다.
스크립트 실행: PyNet 플랫폼의 내부 엔진 내에서 Python 코드를 원활하게 전송하고 실행합니다.
인스턴스 감지: psutil을 통한 PID 추적을 사용하여 활성 Navisworks/Revit 프로세스를 자동으로 찾습니다.
강력한 통신: 저지연 및 고신뢰성 IPC(프로세스 간 통신)를 위해 Named Pipe를 기반으로 구축되었습니다.
개방형 생태계: 모든 MCP 클라이언트(Claude Desktop, Cursor, VS Code, Zed 등)와 호환됩니다.

🛠️ 설치 방법

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

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

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

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

PyPI에서 pynet-mcp-bridge 설치
Claude Desktop 구성 (표준 및 Microsoft Store 버전 모두 지원)
Claude Code 구성 (VS Code 확장 프로그램)

설치 후 Claude Desktop 및/또는 VS Code를 다시 시작하세요.

사전 요구 사항

Navisworks/Revit에 설치된 PyNet 플랫폼 플러그인.
Python 3.10 이상 → python.org

🔧 옵션 B — 수동 설치

1. 패키지 설치:

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": []
    }
  }
}

🛠️ 사용 가능한 MCP 도구

연결되면 AI는 전체 PyNet 도구 모음에 액세스할 수 있습니다:

🔍 시스템 및 연결

list_active_instances: 활성 PyNet IPC 파이프가 있는 실행 중인 Navisworks 프로세스(roamer.exe)를 시스템에서 검색합니다.
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 로그/출력 창의 표시 여부를 전환합니다.

📂 프로젝트 구조

pynet_mcp/: 핵심 MCP 서버 로직 (FastMCP).
pyproject.toml: 패키지 구성 및 종속성 관리.

📄 라이선스

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

PyNet Bridge