Skip to main content
Glama
PyNet Bridge

PyNet Bridge

by RAEN-DT

🐍 PyNet Platform Bridge (MCP)

PyNet Platform Bridge (MCP) — это уровень исполнения, который позволяет моделям ИИ управлять инструментами Autodesk в режиме реального времени.

Он связывает естественный язык → Python → настольные инструменты Autodesk (Navisworks, Revit, AutoCAD), позволяя ИИ автономно создавать, выполнять и дорабатывать рабочие процессы BIM.

Доступные интеграции включают Navisworks Manage, Revit и AutoCAD.

Этот мост выступает в качестве связующего звена между логикой ИИ и настольными API Autodesk, обеспечивая динамическое создание пользовательского интерфейса, выполнение скриптов и автоматизацию процессов BIM с использованием естественного языка.

🔄 Как это работает

  1. Пользователь описывает задачу на естественном языке.

  2. ИИ генерирует скрипт на Python.

  3. PyNet Bridge проверяет и отправляет скрипт.

  4. Плагин PyNet выполняет его внутри Autodesk.

  5. Результаты возвращаются обратно ИИ.

Именно это превращает ИИ из чат-бота в движок исполнения для BIM.


Related MCP server: A2A MCP Server

🚀 В чем сила PyNet Bridge

  • ИИ → Действие: Превращает сгенерированный ИИ код в реальные действия внутри Navisworks/Revit

  • Выполнение в реальном времени: Запуск скриптов мгновенно, не покидая среду BIM

  • Динамическое создание UI: Позволяет ИИ создавать инструменты, кнопки и рабочие процессы «на лету»

  • Надежная связь: Быстрый и стабильный локальный IPC

  • Автоматизация с учетом модели: Работает непосредственно с активными моделями BIM


🛠️ Установка

✅ Вариант А — Автоматический установщик (рекомендуется)

Откройте PowerShell и выполните:

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

Это автоматически:

  1. Проверит наличие установленного Python 3.10+

  2. Установит pynet-mcp-bridge из PyPI (через uv или pip)

  3. Автоматически обнаружит и настроит все установленные ИИ-клиенты:

    • Claude Desktop (стандартная версия и версия из Microsoft Store)

    • Claude Code (расширение VS Code / CLI)

    • Cline (расширение VS Code)

    • Roo Code (расширение VS Code)

Пакет pynet-mcp-bridge включает:

Пакет

Назначение

pynet-mcp-bridge

MCP-сервер, который соединяет модели ИИ с Autodesk Navisworks через PyNET

mcp[cli]

SDK протокола контекста модели (MCP) и инструменты CLI

fastmcp

Высокоуровневый фреймворк MCP-сервера

psutil

Обнаружение системных процессов (поиск запущенных экземпляров Autodesk)

Перезапустите ваш(и) ИИ-клиент(ы) после установки, чтобы применить изменения.

📦 Стартовый пакет библиотек Python (опционально)

Установите рекомендуемые библиотеки Python для написания скриптов в Navisworks/Revit с помощью PyNET:

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

Это установит:

Библиотека

Назначение

pandas

Анализ и манипуляция данными

plotly

Интерактивные графики и визуализации

matplotlib

Статические графики и диаграммы

dash

Веб-дашборды на Python

Это сторонние библиотеки, перечисленные в разделе Разрешенные импорты Python. Модули стандартной библиотеки (json, sys, re и т. д.) уже включены в состав Python.

Предварительные требования

  • Плагин PyNet Platform, установленный в Navisworks/Revit.

  • Python 3.10 или выше → python.org

    ⚠️ Python 3.14 пока не поддерживается. Среда выполнения pythonnet в настоящее время поддерживает Python с 3.7 по 3.13. Если вы столкнулись с ошибкой System.NotSupportedException, упоминающей неподдерживаемую версию ABI, установите 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


🔧 Вариант Б — Ручная установка

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

Эти инструменты позволяют ИИ полностью контролировать среду PyNet, от создания пользовательского интерфейса до выполнения скриптов и системного мониторинга. После подключения ИИ получит доступ к полному набору инструментов PyNet:

🧠 Основные возможности, доступные ИИ

🔍 Система и подключение

  • list_active_instances: Сканирует систему на наличие запущенных процессов Autodesk с активным подключением PyNet.

  • 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: Обновляет метаданные существующей кнопки скрипта или перемещает ее в другой модуль.

  • delete_script_button: Безвозвратно удаляет кнопку скрипта из модуля по Id.

💻 Выполнение и управление консолью

  • send_command: Прямое выполнение скрипта в движке PyNet (целевой PID, имя скрипта, содержимое).

  • get_output_window_status: Проверяет, доступно/видимо ли окно вывода в данный момент.

  • configure_output_window: Переключает видимость окна логов/вывода PyNet.


🛡️ Безопасное выполнение ИИ

PyNet Bridge включает встроенный уровень проверки, который гарантирует, что все сгенерированные ИИ скрипты являются безопасными и контролируемыми перед выполнением.

✔ Предотвращает небезопасные операции ✔ Блокирует несанкционированный доступ к системе ✔ Гарантирует контролируемое взаимодействие с моделями BIM

ИИ остается мощным, но в безопасных границах.

Начиная с v1.1.1, MCP-сервер включает встроенный статический анализатор, который проверяет каждый скрипт перед тем, как он попадет на хост Autodesk. Все скрипты анализируются и проверяются на уровне моста — отклоненные скрипты никогда не покидают MCP-сервер.

Разрешенные сборки CLR

Только эти ссылки .NET разрешены через clr.AddReference:

  • Общие: 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 за считанные минуты.

Установите мост, подключите ваш ИИ-клиент и превратите естественный язык в реальные действия внутри ваших моделей.


❓ Часто задаваемые вопросы

У вас есть вопросы по установке, настройке или использованию? Ознакомьтесь с полной страницей FAQ:

👉 PyNet FAQs


🔗 Как этот MCP вписывается в экосистему

Этот MCP является частью модульной системы, разработанной для обеспечения автоматизации BIM на базе ИИ в инструментах Autodesk.

Этот репозиторий предназначен для работы вместе с:

  • PyNet Platform → Выполняет скрипты внутри Navisworks, Revit и Civil 3D через Python.NET

  • PyNet Library → Предоставляет ИИ контекст с библиотекой скриптов Python

Вместе эти компоненты обеспечивают:

Естественный язык → ИИ → Скрипт Python → PyNet → Autodesk → Действие BIM

Компонент

Репозиторий

Назначение

PyNet Platform

rafa2403nunez-droid/PyNet

Плагин для Navisworks, Revit и Civil 3D — содержит движок Python.NET

PyNet Bridge (MCP)

Этот репозиторий

MCP-сервер — соединяет модели ИИ с PyNET, включая безопасную проверку скриптов

PyNet Library

rafa2403nunez-droid/PyNetLibrary

Библиотека ссылок на скрипты и контекст ИИ

📄 Лицензия

Этот проект лицензирован по лицензии 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