Revit MCP Automation

让 AI 按需启动独立 Revit、连接 MCP、处理常见警告，并在弹窗解除后继续原来的模型操作。

Revit MCP Automation 是运行在 Windows 本机的 Revit 自动化层。它复用 mcp-servers-for-revit 的模型操作工具，补齐从“发起请求”到“Revit 就绪”、以及从“出现弹窗”到“取回操作结果”的流程。

当前版本：自动化宿主 1.0.4；31 个 MCP 工具，其中 5 个为本项目新增。 已验证环境为 Windows x64、Revit 2020、Node.js 24.19.0，以及已安装的 Revit 2020 兼容命令插件。

本仓库发布自动化层源码，不包含 Revit、授权组件、Revit API DLL、第三方命令插件二进制或项目模型。首次安装需要具备下文所列依赖。Revit 会打开正常桌面窗口，运行时需要 Windows 用户保持登录。

能做什么

Related MCP server: revit-mcp

优势在哪里

以下比较针对本项目改造前的本机固定端口、手动开关流程，不代表所有 Revit MCP 产品。

这些优势来自工作流程和防护机制；本项目没有发布吞吐量或性能提升百分比。

工作原理

flowchart LR
    A[AI / MCP 客户端] -->|stdio| B[Node MCP Server]
    B --> C[受管实例 Broker]
    C -->|首次请求| D[当前用户交互式 Windows 任务]
    D --> E[独立 Revit 2020]
    C -->|回环 TCP + 会话认证| F[C# Automation Host]
    F --> G[现有 Revit 命令插件]
    G --> E
    C -->|独立弹窗通道| H[PowerShell / Windows UI Automation]
    H --> E

模型命令和弹窗处理使用不同通道，因此模态窗口阻塞 Revit 主线程时，代理仍有机会读取并处理窗口。详见架构说明。

安装与首次使用

1. 准备已授权的 Revit 2020、兼容命令插件、Node.js 24 x64、Python 3.11+、.NET SDK 和 .NET Framework 4.8 targeting pack。

2. 克隆仓库，生成本地设置并安装锁定依赖。

3. 构建宿主；在 Revit 全部正常关闭后注册加载项和按需启动任务。

4. 将 MCP 客户端指向私有运行时和 src/server.mjs，重新连接一次以刷新工具清单。

逐条可执行的命令、依赖接口要求、安装影响和回滚步骤见安装指南。 这里不是免依赖的双击安装包。

可向支持 MCP 的 AI 客户端发出这样的任务：

查看受管 Revit 的状态。如果尚未启动，读取默认测试模型的当前视图。遇到普通提示，通过 MCP 处理，并继续取回原操作结果。

或者直接使用工具：

{"name":"get_revit_automation_status","arguments":{}}

状态查询不会启动 Revit；get_current_view_info 等模型操作会按需启动。需要指定模型时：

{"name":"open_revit_model","arguments":{"path":"C:\\BIM\\Sandbox\\Example.rvt"}}

弹窗处理规则

• 已知提示依据对话框 ID、消息内容和按钮类型匹配；缺失参照继续打开后，仍需核对模型完整性。

• 多选窗口由代理先读取，再依据用户已有任务授权选择。click_revit_dialog_button 要求窗口句柄、按钮 ID、快照 hash 和选择理由。

• 不把所有 Dialog_Revit_DocWarnDialog 都当作“确定”：同一个 ID 也可能出现“删除图元”。

• 删除、覆盖、丢弃未保存修改、登录、许可和安全授权不属于自动确认范围；超出既有任务授权时仍需用户决定。

• 收到 waiting_for_dialog 后，使用 get_revit_operation_result 获取原结果，不要重新提交原建模命令。

详见弹窗工作流与示例。

验证状态与适用范围

2026-10-28 的本机真实 Revit 验收覆盖冷启动、模型/视图读取、C# 执行、重连复用、指定模型打开、正常退出后重启、真实弹窗点击，以及原命令只创建一个测试标高。15 项 Node 检查和 10 项 C# 弹窗策略检查通过，23 个原插件文件的哈希保持不变。

验证结论见验证说明。测试脚本、测试模型和原始报告保留在本地，不随公开仓库发布。

当前边界：

• 只验证 Revit 2020 + Windows x64；启动参数为简体中文 CHS，规则包含部分英文匹配，未完成其他语言的实机验收。

• 需要已登录的交互式 Windows 桌面；不提供无界面服务、远程多用户调度或无人值守授权登录。

• 依赖现有插件的内部 SocketService 接口，替换插件版本需要重新验证；并非任意 Revit MCP 插件都可直接接入。

• 启动锁跨 MCP 进程协调；模型命令队列位于各 Broker 进程，不是多客户端全局事务队列。同一模型应由一个写入客户端协调。

• 超时和连接丢失不会自动重放写操作；这减少重复写入风险，不等于跨崩溃的 exactly-once 保证。

• 可读取到的原生窗口、按钮和策略范围有限；尚不能保证自动解决全部第三方插件窗口或系统安全桌面。

• send_code_to_revit 可执行 C#，具有当前用户和 Revit 的权限；本集成不是代码沙箱。

仓库导航

参与开发 · 安全与权限 · 第三方依赖声明 · 版本记录

本项目自研代码采用 MIT License。Revit 与 Autodesk 名称属于其各自权利人；本项目为独立社区项目。