ARTICLE · 1161509
Revit MCP 插件是什么?
昨天，我们分享了一张照片到 Revit：一次换热机组的 AI 建模实录。从参考照片、设备布局，到原生管道和管件的重建，那篇文章展示了一次具体的建模过程。
今天，介绍一下这次实践背后的工具：我们正在迭代的 Revit MCP 插件。
它为什么能让 AI 操作 Revit？现在已经可以做哪些事？最近几次更新，又解决了什么问题？这篇文章一起讲清楚。
本文按 Revit MCP 0.8.4 的现有接口与发布记录整理。当前提供 66 个 MCP 工具，以及 Revit 2022—2026 对应版本的插件文件。
0.8.4 当前版本 | 66 MCP 工具 | 2022—2026 Revit 分年份 DLL |
01Revit MCP 是什么？
平时使用 Revit，我们通过功能区、属性面板和鼠标键盘完成建模。接入 Revit MCP 后，也可以向支持 MCP 的 AI 客户端描述任务，让 AI 调用插件提供的工具，完成查询、创建、修改和检查。
例如：
“先检查当前项目的标高和管道类型，再按给定尺寸建立管路，使用原生弯头和等径三通，最后检查连接情况。”
MCP 的全称是 Model Context Protocol，模型上下文协议。可以把它理解为 AI 与外部软件之间的一套通用工具调用约定。
在我们的实现中，工作过程是：
你提出任务 → AI 理解并拆解 → MCP 服务传递工具请求 → Revit 插件调用 Revit API → 返回模型数据和执行结果 → AI 根据结果继续检查或调整。
AI 负责理解任务、选择工具；插件负责在 Revit 中执行已经提供的操作，并返回结果。
如果输入是一张照片或图纸，识图能力来自所使用的 AI 客户端和模型。Revit MCP 提供的是把判断落实到 Revit 模型中的接口。图片缺少尺寸、背面信息或设计说明时，仍需要明确哪些数据有依据，哪些只是估算。
02目前已经能做哪些事？
66 个工具不必逐个记住，按实际工作可以分成下面几类。
查询项目，找到目标构件
可以读取当前文档、标高、构件类型、元素参数和选中对象，也可以按类别、真实标高、类型、视图、名称、编号和空间范围组合查询。
例如：
“查找二层的机械设备，列出编号和类型，并在模型中选中它们。”
“统计各标高的构件数量和原生体积，把缺失体积的对象列出来。”
这类功能让后续操作有明确对象，也方便核对模型现状。
创建和修改常用构件
目前已经提供标高、轴网、直线基本墙、单一无孔水平多边形楼板，以及线性结构梁、支撑等创建接口。
对于族构件，可以加载已有外部 RFA，并放置接口支持的标高型、双标高型和墙宿主型族。门窗、柱或设备能否按预期放置，还取决于所选族的类别、宿主和约束定义。
已有构件可以移动、旋转、复制、修改参数、复制类型或单独更换类型。修改类型会影响同类型实例，因此也提供了影响范围查询。
整理族，并创建受支持的参数化形体
插件可以把已有外部族整理为新副本，保留原文件，并按支持范围调整参数。
对于适合闭合多边形挤出的形体，可以创建参数化族，指定挤出方向和长度参数，再通过尺寸变化检查几何是否随之改变。
这适合截面明确、形体规则的部分构件。复杂设备或异形节点，仍需要合适的族模板、建模方法和几何验证；不能把任意固定模型直接变成完整参数化族。
创建原生管道、管件和设备管口
这是最近几次更新的重点，目前已经提供：
原生管道； 原生弯头、等径三通； 原生变径和单端封头； 原生连接器查询及匹配端口的直接连接； 在可编辑外部设备族的新副本中添加真实管道连接器。
原生管道具有 Revit 的系统类型、直径、参考标高和连接器。弯头、三通等通过 Revit 原生管件接口创建，再检查连接对象是否符合预期。
设备接口也有对应流程：先读取族文件中的实际端面，再在新族副本中创建管道连接器，加载、放置后连接管道。连接器的尺寸参数可以绑定，但设备实体管口是否同步变径，还要看族内是否建立了相应几何约束。
检查模型，辅助交付
目前可以读取实体几何和 Revit 警告，对指定构件进行实体碰撞检查，创建局部三维检查视图、着色并导出视图图片。
还可以检查构件编号、真实标高和统一属性，生成原生数量明细表、读取材料数量，并在满足条件时保存项目或导出 NWC。
这些功能提供复核依据。例如，碰撞工具检查的是指定对象之间的配对，单次支持 2—100 个构件；返回未完成或未解决项时，还需要继续处理。数量和材料数据来自 Revit 原生统计，也需要结合项目计量规则使用。
让批量修改更容易核对
插件提供参数修改预演、删除预览和事务回滚。
参数可以先真实试改再回滚，查看前后值与警告；正式应用时，再核对目标是否发生变化。删除前可以查看依赖对象，避免只看到选中的构件，却漏掉会一起被删除的内容。
支持的模型写入可以组合为事务批次，最多 100 个操作，失败时整体回滚。保存和文件导出等操作有各自边界，需要单独执行。
03为什么这次特别强调“原生管路”？
昨天的案例里，第一稿曾使用常规模型模拟直管、弯头和三通。外观可以接近，但进入管径修改、管件替换和连接检查时，构件类别与真实端口就变得非常关键。
形状贴在一起，并不等于 Revit 中的管网已经连通。
现在的管路接口可以分别创建原生管道和管件，并读取连接器的位置、方向、尺寸以及实际连接对象。这样才能检查泵出口是否接到集管、集管是否接到立管、后集管是否继续接入主管。
这里也要澄清一点：Revit 原生弯头、三通本身通常就是“管件族”。判断时应看它是否属于正确的原生类别、是否具有正确的连接器和连接关系，不能仅凭名称里有没有“族”来判断。
实际使用仍有前提：项目需要已有合适的管件族，并配置相应的布管规则。当前弯头和三通接口要求等径、同系统类型、同参考标高；三通主管需要预先分成两段，异径连接使用独立变径接口。
目前还没有自动路由、在既有主管中点自动切入支管、自动制作管件族或自动配置布管规则的完整流程。管网物理连接成立，也仍需另行完成专业设计和水力校核。
昨天的换热机组案例同样有明确边界：照片中缺少尺寸的部分按比例估算，设备当时仍是视觉族，未配置完整水力接口。因此，它展示了建模和原生管网验证的过程，不能直接作为完成设计验收的结论。
040.8.4 解决的是“有接口，还要优先用对接口”
前面的版本补齐了原生管道、弯头、三通、变径、封头和设备连接器接口。0.8.4 进一步把管路建模的默认要求放进 MCP 启动指引、规则资源和相关工具说明中：
管路默认优先使用原生管道、弯头和等径三通。
原生创建失败时，应先检查管道类型、管件资源、布管规则、端口和空间条件，不应自行改用常规模型模拟，也不应为了创建成功而静默改变设计管径。用户明确要求参考几何时，才按对应范围处理。
检查也不能只看截图。规则要求复核活动视图中的精细实体显示，并在保存后检查实际类别和双向连接。
这次更新没有增加工具数量，仍为 66 个。它调整的是 AI 选择工具和检查结果的工作要求；执行效果仍取决于客户端是否遵循规则，也不会把旧模型中的模拟管路自动转换为原生管网。
05适合怎样使用？
目前比较适合从范围清楚、结果能检查的任务开始：
查询、分类统计和定位构件； 按明确尺寸创建重复构件，整理编号、标高和属性； 依据已有族和项目资源建立设备布置、原生管路； 批量参数修改、局部模型复核、明细表和交付辅助。
给 AI 的指令越具体，越容易检查结果。例如：
先查询当前项目的标高、管道类型和系统类型。按我提供的尺寸创建原生管道，弯头和三通使用原生接口。缺少管件资源时说明缺项。完成后列出新建构件、连接关系、未接端点和 Revit 警告，并建立局部检查视图。
只有照片时，可以先做设备布置和空间关系推演，再补尺寸和连接依据；有图纸、尺寸表和可用族时，再逐步提高模型精度。
屋顶、楼梯、幕墙、风管和电气专用建模接口，以及完整的专业自动校核、Excel 回写等，目前尚未提供或完成。不同 Revit 年份和不同项目模板，也需要分别进行实际验证。
附录版本更新记录
下面按版本从早到晚整理已能追溯的主要更新。
0.3.0
增加外部族加载与副本整理、独立实例编号、统一共享属性、真实 Level 关联、原生体积明细表、模型规范检查和 NWC 导出；停用旧 DirectShape 导入入口。
0.4.1
参数化建族接口支持原生长度参数、X/Y/Z 挤出方向，以及尺寸变化后的几何伸缩验证。该项按现有接口版本门槛和测试记录整理。
0.5.0
修复族模板残留实体和单标高族绝对坐标放置问题；增加 12 个复核、接缝和交付工具，包括实体与碰撞检查、几何连接、梁端连接控制、族内部检查清理、视图及警告读取、材料数量、保存和图片导出。
0.6.0
工具增至 51 个。新增组合查询、分类统计、视图列表、局部三维检查视图、视图着色、参数修改预演及按预演结果应用；增加只读诊断报告和发布文件校验清单，离线版同步相关修复。
0.6.1
优化中文功能区、按钮配色和分隔；离线版增加权限入口，改进授权及监听状态提示；简化安装年份输入。
0.7.0
工具增至 56 个。新增操作策略查询、类型与族影响范围查询、删除预览、按预览删除、未开始请求取消；加强请求状态恢复、防误重发、警告策略及升级回退。
规则增补：2026-09-23
在 MCP 端内置图纸依据、坐标标高、原生构件、节点检查、连接与碰撞覆盖、超时恢复和交付规则；新增规则查询工具及资源，工具增至 57 个。该阶段 Revit DLL 仍为 0.7.0。
0.7.1
将通用建模规则正式整合进完整发布包，统一普通版和离线版版本信息；MCP 初始化、规则查询和资源读取使用同一份规则快照。保持 57 个工具。
0.7.22026-09-30
改进超大结果的摘要和分页恢复，增加结果校验；修复数组、空值等完成日志兼容问题；日志保存失败时提供提醒，避免把已经成功的模型操作误当作失败重做；改进离线激活提示。
0.8.02026-10-10
新增 7 个原生管道与设备连接器工具：管道、弯头、等径三通、连接器查询、端口直接连接、设备族端面检查、设备管道连接器创建。工具增至 64 个，两版同步。
0.8.1
修复创建原生弯头、等径三通时，将管件中心线和逻辑系统对象误判为额外实体而回滚的问题；保留真实实体与物理连接检查，完善诊断及版本显示。
0.8.2
正式整合原生变径和单端封头，工具增至 66 个；支持批次调用，检查原管径和双向物理连接；单端封头要求源管只有一个空闲端，避免误封另一端。
0.8.3
修复设备族连接器创建接口中的源文件占用问题，保留源文件变化校验；继续使用统一正式接口，两版同步。保持 66 个工具。
0.8.42026-10-11
将原生管路优先要求统一到启动指引、规则资源和工具说明；要求活动视图精细实体检查及保存后连接复查。保持 66 个工具，普通版与离线版同步。
后续案例也会继续给出建模依据、实际结果和未解决项。比起只看最终效果图，我们更希望把构件类别、参数、连接关系和复核过程展示出来，让大家能判断模型是否满足自己的使用要求。