🐍 PyNet 平台桥接器 (MCP)

PyNet 平台桥接器是一个模型上下文协议 (MCP) 服务器，使 AI 模型（如 Claude、GPT-4o 或 Gemini）能够通过 PyNet 平台直接与 Autodesk 工具进行交互。

该桥接器充当了 AI 逻辑与 Autodesk 桌面 API 之间的连接纽带，允许使用自然语言进行动态 UI 创建、脚本执行和 BIM 流程自动化。

🚀 主要功能

• 动态 UI 部署： 允许 AI 在 Navisworks/Revit 中实时创建自定义功能区选项卡（模块）和按钮。

• 脚本执行： 在 PyNet 平台内部引擎中无缝发送并执行 Python 代码。

• 实例检测： 通过 psutil 进行 PID 跟踪，自动定位活动的 Navisworks/Revit 进程。

• 稳健通信： 基于命名管道 (Named Pipes)，实现低延迟、高可靠性的 IPC（进程间通信）。

• 开放生态： 兼容任何 MCP 客户端（Claude Desktop、Cursor、VS Code、Zed 等）。

🛠️ 安装

✅ 选项 A — 自动安装程序（推荐）

打开 PowerShell 并运行：

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

这将自动执行以下操作：

1. 从 PyPI 安装 pynet-mcp-bridge

2. 配置 Claude Desktop（支持标准版和 Microsoft Store 版本）

3. 配置 Claude Code（VS Code 扩展）

安装后请重启 Claude Desktop 和/或 VS Code。

前置要求

• 在 Navisworks/Revit 中安装了 PyNet Platform 插件。

• 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：握手 ping，以验证插件监听器是否响应。

🏗️ 模块 (选项卡) 管理

• 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 许可证授权。