🐍 Мост платформы PyNet (MCP)

PyNet Platform Bridge — это сервер протокола контекста модели (MCP), который позволяет моделям ИИ (таким как Claude, GPT-4o или Gemini) напрямую взаимодействовать с инструментами Autodesk через платформу PyNet.

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

🚀 Ключевые особенности

Динамическое развертывание пользовательского интерфейса: Позволяет ИИ создавать пользовательские вкладки ленты (модули) и кнопки в Navisworks/Revit в режиме реального времени.
Выполнение скриптов: Беспрепятственная отправка и выполнение кода Python непосредственно во внутреннем движке платформы PyNet.
Обнаружение экземпляров: Автоматический поиск активных процессов Navisworks/Revit с использованием отслеживания PID через psutil.
Надежная связь: Построено на именованных каналах (Named Pipes) для межпроцессного взаимодействия (IPC) с низкой задержкой и высокой надежностью.
Открытая экосистема: Совместимость с любым клиентом MCP (Claude Desktop, Cursor, VS Code, Zed и т. д.).

🛠️ Установка

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

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

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

Это автоматически выполнит следующие действия:

Установит pynet-mcp-bridge из PyPI
Настроит Claude Desktop (поддерживаются как стандартная версия, так и версия из Microsoft Store)
Настроит Claude Code (расширение для VS Code)

Перезапустите Claude Desktop и/или VS Code после установки.

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

Плагин PyNet Platform, установленный в Navisworks/Revit.
Python 3.10 или выше → python.org

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

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

После подключения ИИ получит доступ к полному набору инструментов PyNet:

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

list_active_instances: Сканирует систему на наличие запущенных процессов Navisworks (roamer.exe) с активным каналом IPC PyNet.
check_plugin_status: Проверочный пинг для подтверждения того, что прослушиватель плагина отвечает.

🏗️ Управление модулями (вкладками)

get_pynet_ui_layout: Получает полную структуру пользовательского интерфейса (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_mcp/: Основная логика сервера MCP (FastMCP).
pyproject.toml: Конфигурация пакета и управление зависимостями.

📄 Лицензия

Этот проект лицензирован по лицензии MIT.

PyNet Bridge