Horizun Revit MCP

Horizun Revit MCP — 在 Revit 中建模、编写文档、处理坐标并交付

由 Horizun Group 在哥伦比亚 🇨🇴 打造。

Horizun Revit MCP 是一款免费的开源 Windows MCP 服务和 Revit 插件，适用于 Autodesk Revit 2023–2027。完整目录包含 125 个工具， 涵盖 481 个命名子操作和分发模式， 用于建筑和结构建模、MEP、参数化族、图纸、 CAD 到 BIM、模型审计、工程量、Excel、Power BI 和导出。

在 MCP 客户端中使用自然语言目标，创建新的 BIM 内容、 检查现有模型并执行多步骤生产工作流。对类型化更改，可先进行预演，明确指定目标并在提交后验证； 启用所有者权限的 Python 可将桥接扩展为针对任务的 Revit API 自动化。 可下载的 Windows 安装程序包含服务运行时和 Revit 插件。

English · Español

下载 · 观看演示 · 3.0 版新内容 · 使用 Claude Desktop Free 安装 · 所有工具 · 子操作 · 发布测试证据 · 安装

3.0 版新内容

• **钢筋：**类型化钢筋规则现已涵盖穿过主体的钢筋、锚固、搭接、截面、楼板、基础、墙、柱、连接器、交叉顺序以及提交后的几何审计。horizun_read_schedule 可读取矢量 PDF 或 DWG 配筋表卡片，并拒绝处理含糊的行。请参阅钢筋功能矩阵。
• 互操作性：horizun_exchange 可生成并验证 horizun.exchange/0 清单、携带模型身份信息，并在应用审查修正计划前后进行检查。请参阅工具详情。
• **按需提供架构：**默认仍为 full。对每个客户端设置 HORIZUN_SCHEMA_MODE=facade，即可仅开放健康状态工具以及三个服务端发现/调用工具，并按需获取精确架构。tools/list 大小测得的缩减幅度尚未通过完整的 Agent 对比进行验证。请参阅客户端设置和测量结果。
• 本地工具集：HORIZUN_TOOLSETS=local 可为上下文较短的客户端缩小公开的类型化工具范围，同时保留权限门控。架构模式和工具集互相独立。

对于现有安装，请按照迁移到 3.0操作：协议 3 要求同时更新服务和插件。发行说明概述了此次发布内容。

产品概览

界面	可用内容	查看
MCP 入口	125 个工具，其中 46 个为只读工具，79 个可能产生影响	生成的清单和下方的完整目录
内部操作	多操作工具中的 481 个命名子操作和分派模式	下方的确切选择器值
Revit 覆盖范围	2023、2024、2025、2026 和 2027	五个对应的加载项和版本化实时报告
新建模型内容	26 种构件类型；参数化 RFA 创建；结构和 MEP 规划	创建与族参考
图纸和交付成果	24 个视图/图纸操作、10 个注释操作、原生明细表和图纸布局	平面图制作
导出目标	PDF、DWG、DGN、DWFx、IFC、NWC、FBX、gbXML、COBie、RFA 族、图像和明细表 CSV	horizun_export
已验证的发布示例	在 v1.3.3 中，跨五个 Revit 年份通过 1,230 次探测执行	已发布的报告
安装	Windows 安装程序已包含运行时；最终用户无需 Git、Visual Studio 或 .NET SDK	各客户端的最终步骤

这些计数描述了完整的产品范围。当前权限配置文件和工具包决定特定会话可用的工具；下文会说明经测量的 70/79/80 工具配置文件。

2.1 版本更新内容

以下每项都是此版本的一部分，均遵循相同的已验证写入流程（预演、令牌、应用、重新读取）；在存在测试样例的情况下，均已在 Revit 中进行实时测量。每项的详情见 CHANGELOG。

新工具和新的构建方式

1. 轻钢龙骨，horizun_framing — 在墙体图层内布置立柱、沿顶沿地龙骨、边柱、门窗洞口立柱、过梁、窗台、短柱和横撑，以及吊顶龙骨；MCP 客户端从图像或 DWG 中读取详图规格（提示词 framing-from-detail）。
2. 幕墙方式的龙骨 — 使用幕墙和扁平坡面玻璃图层建模相同的龙骨（立柱竖梃、固定间距网格、连接至上层楼板的吊件），适用于采用这种方式的团队。
3. 拆分带洞口的多层墙 — horizun_split_multilayer_walls 现在可转换承载门、窗和嵌套构件的墙：承载墙保留其标识和嵌入构件，每一层则成为独立的墙。
4. COBie 2.4 工作簿 — horizun_export format=cobie：包含 Facility、Floor、Space、Zone、Type、Component 和 System 工作表，逐单元格重新读取，并提供 deliverable_ready 以及针对每个缺失必填值的发现项。
5. 新增构件类型 — horizun_create_elements 支持喷头、软管、柔性风管、空间、区域和区域边界；可为每个空的回路创建房间和空间（placement=all_enclosed）；支持地形实体（Revit 2024+）。
6. 编辑草图而不丢失构件 — 对楼板、天花板和洞口使用 edit_sketch，可保留标识和宿主数据。

MEP 与碰撞解决

7. 自动 MEP 路由 — horizun_mep_routing route：绕开实体和链接构件的正交三维路径，并在每个连接点重新读取管段和弯头。
8. 重力坡度 — slope：从固定端开始，按目标坡度铺设管线，并重新读取每个连接。
9. 吊架 — hangers：在结构下方按间距布置调用方族（宿主或链接构件）。
10. 碰撞洞口和套管 — 当移动无法解决碰撞时，horizun_resolve_clash propose_opening / apply_opening 会切割墙、楼板、屋面和天花板，或放置套管族。
11. 与链接构件和连接管线的碰撞 — 移动操作会对照每个已加载的链接构件进行检查；连接的管道-弯头-管道网络会作为一个刚体整体移动（run_shift）。
12. 系统分析 — horizun_plan_mep system_analysis 会读取 Revit 计算出的关键路径、压力损失、流量和流速。

协同、CDE 与 openBIM 13. ACC 问题 — horizun_cde_cloud issues_list / issue_create / issue_update，以已登录用户的身份执行，通过外部键实现幂等，并在每次写入后回读。 14. Navisworks 往返流程 — 检查 Navisworks 所需 3D 视图是否就绪并进行准备，以及根据协调台账提供状态建议。 15. 从任意工具生成 BCF — 解析 Navisworks、ACC、Solibri 或 BIMcollab 主题（BCF 2.1/3.0），支持按 IFC GUID 或创作工具 ID 定位。 16. ISO 19650 信息管理 — 项目上下文（project-intake）、跨 WIP/Shared/Published/Archived 的信息容器，以及依据 IDS、Pset 映射和地理参考验证 IFC 交付。 17. 与中心模型同步 — horizun_document_session sync_with_central，默认关闭，仅由机器所有者在 Revit 中启用；可选择放弃全部借用、保留借用或不处理，并在同步后验证。 18. 共享坐标、点云和扫描偏差 — 使用 acquire_coordinates、点云链接和 scan_deviation 比较模型面与扫描结果，并测量覆盖范围。

可见的验证结果

19. 每次写入后进行空间检查 — 随写入报告重叠、门被阻挡、重复对象和 MEP 穿过结构等问题；horizun_verify_changes 会返回一张突出显示已更改元素的图像。
20. 前后快照 — 使用 snapshot / compare_to，采用相同相机视角，并将红色差异映射回已写入的元素。
21. 设备净空区 — 使用 clearance_rules 检查工作空间区域与主体及链接模型。
22. 疏散行走距离 — 使用 Revit 的路径行走功能执行 horizun_code_check，报告距离下限；无法判定时返回 not_decidable 及原因。
23. 能源就绪情况 — energy_readiness 会构建并回滚能源模型，并报告围护结构、构造和窗墙比。

文档、工程量和交换

24. 更多导出格式 — 在单个作业中为多个视图或图纸导出 DWG，以及导出 gbXML、DGN、DWFx 和已载入族到 .rfa；每个文件都会回读。
25. 按房间统计装修面 — horizun_quantities room_finishes：按材料统计每个房间或空间的墙面、地面和天花板面，并扣除洞口。
26. 将预算导出为 BC3 — 从工程量清单和调用方价格使用 horizun_budget_compare export_bc3（FIEBDC-3）。
27. 图纸和视图 — renumber_sheets 会先检查编号冲突；set_view_display 会修正细节级别或专业，并引用审计发现。
28. 结构分析模型和荷载 — horizun_query_structure analytical 和 loads，按荷载工况分组。
29. Power BI 协调仪表板 — 基于协调台账的 .pbip 示例。
30. 更精简的工具列表 — tools/list 缩小约 64 KB，且未移除任何工具、参数或操作，因此客户端加载更快。

查看真实工作流：将 PDF 平面图转换为 Revit 模型

PDF 平面图 → Revit 模型（使用 AI）——在 YouTube 上观看 是 Horizun Hub 频道发布的西班牙语演示视频。 视频展示了由 AI 客户端驱动的 PDF 到 Revit 工作流。PDF 解读 由客户端／模型负责；Horizun 提供在 Revit 中执行的操作。 下方单独介绍的类型化 DWG 工作流会读取 CAD 几何和带版本的规则。

你可以构建和交付的内容

建筑、结构和机电建模

horizun_create_elements 接受依赖关系感知型批次，可创建楼层、轴网、墙、楼板、天花板、屋顶、房间、族实例、结构梁和柱、梁系统、墙基础、风管、管道、导管、电缆桥架、管件、管线附件、机电系统、洞口、竖井、房间分隔线、异形墙、位移集和受支持的楼梯。

子操作表列出了全部 26 种创建类型和 5 种管件选项。horizun_transform_elements 可处理移动、复制、旋转、墙连接、类型／曲线更改和标记放置。horizun_manage_system_types 支持复合材料层结构和机电连接偏好设置。结构和机电规划器会生成使用这些相同创建工具的请求。

新建参数化族，包括机电连接器

horizun_create_family 可从已安装的 .rft 新建 .rfa：包括参数、公式、命名类型、实体／空心拉伸、融合、旋转、扫掠和放样融合；参照平面和带标签的尺寸标注；受支持的嵌套族；以及管道、风管、电气、导管或电缆桥架连接器。系统会验证保存和可选的项目加载。 RFA 示例和模板范围。

图纸、自动标注和图纸集制作

创建楼层／天花板／结构／面积平面图、剖面图、立面图、详图索引、绘图视图和 3D 视图。管理视图样板、阶段、裁剪、视图范围和范围框；创建、复制和填充图纸；放置明细表并对齐视口。标注工具支持文字、标记、线性／角度／半径／直径／弧长尺寸标注，以及高程／坐标／坡度点标注。

根据明确的条件规划尺寸标注和标记，检查几何参照，创建 2D 详图，审核平面图，应用附有引用依据的修正，并整理图纸区域。horizun_plan_views 和 deliverable-production 提示词可协调交付阶段和审批状态。绘图工作流。

DWG 转 BIM，并支持可追溯的修订更新

检查 DWG 实例、图层和曲线。提供带版本的需求集，将图纸内容映射为有序的 BIM 计划。通过类型化工具预演并应用该计划，同时为创建的元素附加源指纹和来源信息。根据图纸审核模型；规划并应用后续 DWG 修订，同时识别需要审核的手动模型编辑。 这些功能由 7 个专用 CAD 工具提供，下文逐一列出。 DWG 转 BIM 示例。

审核、协调、工程量和数据交换

使用类别、族／类型、楼层、参数和空间筛选条件查询宿主模型和已加载的链接模型。扫描模型健康状况，审核所提供的需求，并进行已验证的参数修正。通过持久化问题记录、指派、决策和基于模型测量的解决结果来协调碰撞。规划钢筋，应用受支持的钢筋请求，并审核其结果。

生成材料工程量表，与 Excel 预算基线进行比较；读取或追加 XLSX 行，无需 Excel／COM；将已批准的数据推送到 Power BI，并导出经过验证的交付成果。工程量、Power BI、审核入门指南。

专用模型转换和地形处理

分离墙或楼板图层，按边界环拆分楼板，将受支持的墙体几何矩形化，解组并跟踪原点，再按参数重新成组。传递楼板标高，将楼板嵌入地形实体，并使用折断线和指定坡度整地。墙体图层分解会保留核心墙的标识及其附属元素。捆绑的配方工具使用随附的 Python 处理几何，并由宿主控制预演、事务及声明的回读检查；任意由客户端生成的 Python 则遵循单独的权限／证据约定。

安装

下载 Windows 安装程序

• 需要 Windows x64、Revit 2023–2027 和 MCP 客户端。
• 安装程序包含服务运行时和对应的 Revit 加载项。 无需 Git、Visual Studio 或 .NET SDK。
• 运行安装程序前，请关闭 Revit。
• 服务和加载项有意保持未签名；从 v3.0.2 起，安装程序由 HORIZUN GROUP S.A.S. (Certum) 签名。SHA-256 校验用于验证下载的字节内容；不能验证 Windows 发布者身份。Revit 可能会显示加载项未签名的警告。请参阅签名政策。

1. 打开上述发布页面，从 Assets 下载 horizun-mcp-<version>-setup.exe 和 SHA256SUMS.txt。源代码 ZIP 用于开发。
2. 按照安装指南验证哈希，然后运行安装程序。
3. 完成客户端的连接步骤：

客户端	最后连接步骤
Codex / Claude Code	关闭客户端后，让安装程序的辅助程序完成注册，然后重新打开客户端。
Claude Desktop	在 设置 → 扩展 中安装从 Documents\Horizun-Revit-MCP 获取的 .mcpb，然后重启 Claude Desktop。
ChatGPT Work	完成已安装服务的 Secure MCP Tunnel 设置。
其他 stdio 客户端	使用已安装可执行文件的完整路径进行注册。

4. 启动 Revit，打开一个文档，并让客户端调用 horizun_health。确认当前文档和已加载的版本。

**Claude Desktop 需要在应用内安装扩展。**安装程序会将软件包和图文说明放入上述 Documents 文件夹。将软件包拖到扩展页面，或使用 高级设置 → 安装扩展。 该扩展连接到已安装的服务，不会取代安装程序。请参阅客户端说明和恢复指南。

安装视频：Claude Desktop Free

将 Revit 连接到 Claude Desktop Free — 观看安装教程 这是 Horizun Hub 发布的西班牙语指南，介绍如何使用免费的 Claude Desktop 方案安装并连接 Horizun Revit MCP。请按照上文的安装程序和 .mcpb 步骤操作；客户端指南提供了书面说明。

可选 PowerShell 引导脚本

此脚本会下载发布版安装程序、校验其哈希并静默运行安装程序。 -AllowUnsigned 表示确认已知晓上文所述的发布者状态。仍需完成对应客户端的最后步骤；使用 -Interactive 打开向导。

$s = irm https://raw.githubusercontent.com/HorizunGroup/horizun-revit-mcp/main/install-release.ps1; & ([scriptblock]::Create($s)) -AllowUnsigned

脚本从 main 获取；其校验和检查针对下载的安装程序。你可以先下载并检查脚本。请参阅安装选项。

完整工具目录

此处列出了所有 MCP 工具，并按其执行的工作分组。这些分组仅供阅读参考；会话工具包是可配置的工具集合，具体实现在 ToolPacks.cs 中。说明维护在双语目录中；数量和成员列表会与服务生成的清单进行核对。 详细工具参考介绍参数和限制。

连接、文档和后台任务

工具	功能
get_document_info	检查打开文档的标识和元素数量。
horizun_document_session	通过明确的会话操作检查、打开、保存、另存为和关闭文档，或根据模板创建空白项目。
horizun_file_info	读取 RVT/RFA 文件头、版本和工作共享元数据，不打开或升级文件。
horizun_health	报告桥接服务的运行状况、活动文档、版本、提交记录和 Python 运行时状态。
horizun_job_status	在 Revit 忙碌时或进程重启后，读取进度和恢复状态。
horizun_open_document	打开模型，并检查版本升级和工作共享中心文件。
horizun_relinquish_all	释放拥有的工作共享元素，并报告仍被占用的元素。
horizun_repair_memory	报告并恢复此桥接服务在记录无法读取时保留的持久状态。
horizun_save_document	保存文档并检查生成文件的时间戳和大小。
horizun_selection_exchange	读取用户在 Revit 中选中的内容，并提供一组元素供用户选择。
horizun_submit_job	提交长时间运行的 Revit 操作，并为其分配持久的任务标识符。
horizun_target	在打开多个会话或多个年份版本时，选择要控制的 Revit 实例。

模型查询、审计和修正

工具	功能
horizun_apply_corrections	预演并应用受支持的审计修正，并逐项验证结果。
horizun_apply_ifc_plan	通过会预演并重新读取自身操作的类型化命令执行 IFC 计划。
horizun_audit_access	报告此桥接服务在本机上获准执行的操作，以及作出决定的人。
horizun_audit_model	根据提供的模型要求进行评估，并提供发现项、覆盖情况和预防门禁证据。
horizun_capture_view	将活动视图或指定视图导出为图像，供客户端进行视觉审查。
horizun_verify_changes	检查上次写入所做的更改是否存在空间冲突，并返回标出冲突的图像。
horizun_delete_verified	删除指定 ID 或清除未使用的内容；预览级联影响并验证删除结果。
horizun_list_elements	列出并分页显示宿主模型和已加载 Revit 链接中的元素，并附带模型标识。
horizun_model_scan	检查模型健康状况、警告、工作集、链接、族、视图和可清理项。
horizun_navigate	选择元素、清除选择、缩放和打开视图。
horizun_plan_from_ifc	根据声明的映射从 IFC 文件规划 Revit 元素，而不导入该文件。
horizun_query_model	按类别、类型、楼层、参数和空间边界筛选；投影字段并返回分组或精简摘要。
horizun_validate_ids	根据 IDS 规范检查模型，并报告每项未通过的要求。
horizun_query_classification	读取关键注释表和装配代码表、它们在模型中的使用情况、缺失和未使用的代码，以及族的查找表。
horizun_model_diff	对模型创建快照并比较交付内容：新增、删除和更改的元素及其参数、彩色视图、纯文本摘要和质量历史记录。
horizun_code_check	根据声明式要求集检查模型，包括哥伦比亚的无障碍、疏散和照明规则；无法判定时返回 not_decidable，而不进行猜测。
horizun_undo	列出并撤销最近一次经过验证的 Horizun 批次；若模型或文件自那之后发生变化，则拒绝撤销。

模型创建、参数与系列

工具	功能
horizun_bind_shared_param	将共享参数绑定到类别，并检查组变化行为。
horizun_copy_between_documents	在打开的文档之间复制元素，保留标识，并报告被替换的内容。
horizun_create_elements	以类型化批次创建标高、轴网、墙、楼板、屋顶、房间、族实例、结构构件、机电管线、洞口和楼梯。
horizun_create_family	创建新的参数化 RFA 文件：包括实体/空心形体、参数、公式、类型、嵌套族和机电连接件；也可选择加载这些文件。
horizun_family_apply	在事务中应用族编辑，并通过几何不变量检查及在发生偏移时回滚。
horizun_manage_materials	读取、创建和指定材质及其外观和标识数据。
horizun_manage_system_types	复制系统类型；编辑参数、墙/楼板/屋顶/天花板的图层结构以及机电连接偏好设置。
horizun_set_keynote	指定键注释值，并明确受影响的实例/类型范围。
horizun_transform_elements	对明确指定的目标执行移动、复制、旋转、固定、类型或曲线更改，以及调整标记头/引线。
horizun_write_params_verified	批量写入参数值，并重新读取每个请求的值。
horizun_manage_parameters	读取完整的绑定映射、创建并绑定共享参数、重新绑定或移除绑定，以及管理全局参数。
horizun_manage_curtain	读取并编辑幕墙网格：网格线、竖梃和面板类型；每次更改后重新测量。
horizun_slab_shape	编辑楼板和屋顶形状：点、分割线和顶点标高，并支持重置。
horizun_create_railing	在楼梯或坡道上创建栏杆，或根据标高上的绘制路径创建栏杆。
horizun_manage_phases	读取阶段、过滤器和设计选项；设置元素阶段，并创建或编辑阶段过滤器。
horizun_manage_assemblies_parts	创建、划分、排除和合并零件；创建包含视图的装配，并拆解装配。
horizun_manage_styles	读取和设置对象样式、子类别、线样式、线型和填充图案。
horizun_manage_units	读取和设置项目单位、项目信息以及基点和测量点（需明确同意）。

图纸、标注、图纸集和明细表

工具	功能
horizun_manage_views	创建和配置平面图、剖面图、立面图、详图索引、3D 视图、图纸、视口和明细表布局。
horizun_plan_views	规划房间视图和交付集；跟踪交付状态、审批和失效情况。
horizun_query_planimetry	检查图纸、视图、布局、注释和图纸引用，并查看几何信息和覆盖范围。
horizun_audit_planimetry	审核图纸要求，并返回带引用依据的检查结果以供修正。
horizun_fix_planimetry	修正有引用依据的视图、图纸、标题栏、视口、明细表和裁剪问题。
horizun_pack_sheets	在给定的图纸区域内放置视图和明细表，并检查放置结果。
horizun_plan_annotations	根据明确标准，规划为轴网、标高、幕墙和洞口自动添加标记和尺寸标注。
horizun_annotate	创建文字、标记、线性／角度／半径／直径／弧长尺寸标注，以及标高、坐标或坡度点标注。
horizun_get_dimension_references	查找可用于尺寸标注请求的几何参照。
horizun_query_dimensions	检查现有尺寸标注、分段、参照和测量值。
horizun_edit_dimensions	应用支持的尺寸标注编辑，并验证编辑后的尺寸标注状态。
horizun_query_detail_2d	读取视图的详图几何、线样式、区域类型和可放置的符号。
horizun_detail_2d	以经过验证的原子批次创建详图线／弧线／多段线、填充／遮罩区域和构件。
horizun_manage_revisions	创建和更新图纸修订记录。
horizun_create_schedule	创建原生明细表，并选择字段、排序方式和可选的关联元素。
horizun_manage_schedules	创建、复制和配置明细表、材料用量表、图纸／视图列表、修订明细表和索引图例。
horizun_list_schedules	列出明细表，并检查字段、关联文件设置和显示尺寸。
horizun_get_schedule_data	读取明细表中显示的单元格，并指定行／列范围和截断信息。

CAD / DWG 转 BIM 和修订更新

工具	功能
horizun_apply_cad_plan	通过类型化命令构建模型；验证源文件哈希，并为创建的元素添加 CAD 来源信息。
horizun_apply_cad_update	应用支持的修订变更，并保留来源信息以供下次更新使用。
horizun_audit_cad_model	根据来源信息、几何和测量差异，对比图纸与模型。
horizun_cad_connect	构建图纸声明的连接，为每个接合点放置所需管件并进行验证。
horizun_cad_extract	提取 CAD 几何；若源 DWG 可读，还可提取文字，并根据测量间隙规划详图转移。
horizun_cad_networks	推导图纸描述的网络：哪些端点相接、它们之间应连接什么，以及哪些端点保持开放。
horizun_cad_review	报告转换中无法确定的内容，并提供每个暂存候选项的证据。
horizun_cad_symbols	列出图纸定义的块符号及其各自的放置位置。
horizun_cad_unit_instances	查找图纸中的重复单元，以及放置每个实例的变换。
horizun_manage_cad_links	列出、添加、重新加载和更改 CAD 链接指向，并提供测量状态。
horizun_plan_cad_update	规划 DWG 修订之间的变更，同时识别需要审核的手动模型编辑。
horizun_plan_from_cad	使用提供的版本化规则解读 DWG，并返回按依赖顺序排列的 BIM 计划，其中包含遗漏项和来源信息。
horizun_query_cad	检查 DWG 实例、图层、曲线几何、轮廓和可读覆盖范围。

结构、钢筋、MEP 和协调

工具	功能
horizun_acc_upload_status	读取 Desktop Connector 日志，查看本地文件分配到 ACC 文件夹的证据。
horizun_apply_reinforcement	应用受支持的钢筋方案，并执行类型化检查和验证。
horizun_audit_reinforcement	根据提供的要求审计钢筋，并报告覆盖情况。
horizun_clash	检测指定范围内的碰撞、规划受支持的穿孔，并记录协调问题。
horizun_connect_mep	连接或断开指定的 MEP 连接器；不会通过移动几何图形来消除可见间隙。
horizun_coordination	跟踪协调问题、分配、决策、证据，以及模型检测到的问题解决或回退。
horizun_manage_links	管理 Revit 链接，并在明确说明不确定性的前提下筛选链接视图候选项。
horizun_plan_mep	规划管道／风管路径和管件；通过实际连接器连通性检查网络。
horizun_read_schedule	将钢筋明细表图纸（矢量 PDF、DWG 实体）读取为钢筋行和具名自检项，并按标记将梁卡片建议作为一组要求提出；无法读取的内容将予以拒绝。
horizun_plan_reinforcement	根据提供的主体和钢筋要求规划钢筋。
horizun_plan_structure	在轴网交点处规划柱，并沿连续轴网交点规划梁。
horizun_query_structure	检查构件、主体、保护层、钢筋、钢筋系统、连接和数量。
horizun_structural_connections	读取并应用框架构件之间的结构连接类型。
horizun_mep_routing	读取和编辑路由首选项及目录尺寸；将 MEP 管线调整为目录尺寸，并按流量规划尺寸。
horizun_electrical	列出配电盘和回路、创建回路、分配配电盘、添加或移除构件，以及创建配电盘明细表。
horizun_resolve_clash	为 MEP 碰撞提出并执行幅度最小且安全的移动，通过重新检测验证；若产生任何新碰撞，则回滚。
horizun_federation_check	检查每个联合模型是否仅包含其专业内容、预期链接以及一致的共享坐标。

图层、组和地形

工具	功能
horizun_split_floor_loops	按草图轮廓拆分楼板，同时保留高度偏移。
horizun_split_multilayer_walls	分离墙体图层，同时保留原核心墙的标识及其宿主构件。
horizun_framing	根据详图规范，在墙体图层内构建轻型薄壁型钢龙骨，并构建悬吊式天花龙骨（主龙骨、覆面龙骨、周边龙骨、连接至结构的吊杆）；构建结果经过验证、可读取且可移除。
horizun_split_multilayer_slabs	分离楼板／天花板材料图层，同时保留轮廓，并支持逐块楼板回滚。
horizun_rectangularize_walls	将受支持的正交墙体几何图形分解为矩形片段。
horizun_ungroup_and_mark	取消模型组，同时记录每个成员所属的源组。
horizun_regroup_by_param	根据提供的分组参数重建模型组。
horizun_copy_slab_elevations	将成形楼板表面传递到明确指定的目标楼板。
horizun_embed_floors_in_toposolid	将楼板轮廓和标高嵌入地形实体。
horizun_grade_toposolid_around_floors	按偏移、断裂线和指定边坡坡度对楼板周围的地形进行整平。
horizun_manage_groups	管理组、查找重复项、预览注释并保留图案位置。
horizun_manage_worksets	列出、创建和重命名工作集，在工作集之间移动构件，并设置各视图中的可见性。

工程量、Excel、Power BI 和交付成果

工具	功能
horizun_quantities	使用单位、分组和模型来源信息测量体积和材料工程量。
horizun_budget_compare	将模型工程量与 Excel 基准进行比较；也可选择写入经批准的 Excel/Power BI 输出。
horizun_catalog_lookup	从提供的目录中查找项目，并提供叶节点状态和文件哈希来源信息。
horizun_excel_read_rows	读取 XLSX 行、类型和缓存的公式值，无需 Excel 或 COM。
horizun_excel_write_rows	追加 XLSX 行（或新建工作簿），在 Horizun 状态文件夹中保留备份，并重新读取已写入的单元格，无需 Excel 或 COM。
horizun_power_bi_push	将行发送到 Power BI 推送语义模型表，并提供持久重放保护和目标回执。
horizun_export	导出 PDF、DWG、IFC、NWC、FBX、图像和进度计划 CSV，并验证输出文件。
horizun_link_schedule	导入 MS Project、Primavera 或 CSV 进度计划，将活动关联到构件，写入日期并为 4D 状态视图着色。

可组合工作流和自定义 API 自动化

工具	功能
horizun_execute_plan	组合最多 100 个带类型的操作，支持依赖项、先前结果引用和 TransactionGroup 回滚。
horizun_execute_python	运行由客户端生成、针对 Revit API 的 Python 代码，包括预检和脚本提供的证据；需要所有者选择加入。
horizun_promote_script	将已验证的脚本提升为命名过程，使其不再是临时代码。
horizun_request_python_access	在 Revit 中显示所有者审批请求，以执行自定义 Python。
horizun_run_procedure	运行此机器上已存储的命名版本化过程，并单独征求同意。

ISO 19650 信息管理和 openBIM 交付

工具	功能
horizun_project_context	验证、询问并起草项目的 ISO 19650 上下文：委任、EIR/BEP/MIDP、CDE 状态、命名和交付；通过强身份凭据登记其模型。
horizun_exchange	使用经过验证的 horizun.exchange/0 清单封装跨应用传递，在使用前检查清单，并协调评审的修正计划。
horizun_information_container	为信息容器命名、封存、验证、检查，并在 WIP、Shared、Published 和 Archived 文件夹之间转换。
horizun_deliver_ifc	导出 IFC 并验证交付：对文件运行 IDS 检查、检查属性集映射覆盖率和地理参考、生成失败项的 BCF，并封存容器。
horizun_cde_cloud	按状态读取云端 CDE（Autodesk Construction Cloud 或 OpenCDE 服务），并与 MIDP 进行交叉核对；仅限只读。

子操作和模式

一个命名的 MCP 工具可以分派多种操作。例如，创建墙体、管道和楼梯是 horizun_create_elements 下的不同选项；创建剖面和放置明细表则是 horizun_manage_views 下的不同操作。

该表列出了 26 个多操作工具中的 481 个命名子操作和分派模式。 每种选择都按工具、选择器属性和值计数一次，包括嵌套选择器。重复的 oneOf 架构路径会去重。有些选择器用于细化另一项操作：这些数字描述的是 已公开的操作词汇，而不是额外的 208 个顶层工具。

工具	选择器	命名子操作和模式
horizun_document_session	operation	open、save、save_as、close、inspect、sync_with_central、new_project
horizun_repair_memory	operation	list、advice、observe、remedy、quarantine、release
horizun_selection_exchange	operation	publish、read、clear、capabilities
horizun_audit_model	operation	save、save_as、sync_with_central、export、publish、close_with_save、batch_open_close
horizun_verify_changes	operation	check、snapshot、compare_to
horizun_delete_verified	mode	ids、purge_unused
horizun_navigate	operation	select、clear_selection、zoom、select_and_zoom、open_view
horizun_validate_ids	operation	precheck、validate
horizun_query_classification	operation	keynote_table、assembly_code、family_lookup_tables、unused_codes、missing_codes
horizun_model_diff	operation	snapshot、list、compare、colorize、explain、record_quality、quality_trend
horizun_code_check	operation	check、travel_distance、energy_readiness、headroom
horizun_undo	operation	list、undo_last
horizun_create_elements	kind	level、grid、wall、floor、ceiling、roof、room、family_instance、sprinkler、structural_framing、structural_column、duct、pipe、conduit、cable_tray、flex_pipe、flex_duct、fitting、wall_opening、slab_opening、beam_system、wall_foundation、accessory_inline、mep_system、shaft、room_separator、space、area、area_boundary、wall_profile、displacement、stairs、toposolid
horizun_create_elements	fitting	elbow、union、transition、tee、takeoff、cross
horizun_create_family	kind	extrusion、blend、revolution、sweep、swept_blend、pipe、duct、electrical、conduit、cable_tray、symbolic、model
horizun_manage_materials	operation	create、duplicate、update
horizun_transform_elements	operation	wall_join、move、copy、rotate、mirror、pin、unpin、change_type、change_type_by_rule、realign_wall_sketch、set_curve、move_tag_head、set_tag_leader、array_linear、array_radial、rename_level、edit_sketch
horizun_manage_parameters	operation	list_bindings、create_shared、create_project、rebind、remove_binding、global_list、global_create、global_set、global_delete
horizun_manage_curtain	operation	read、add_grid_line、remove_grid_line、set_mullions、set_panel_type
horizun_manage_curtain	mode	add、remove
horizun_slab_shape	operation	read、add_point、add_split_line、modify_subelement、reset_shape
horizun_manage_phases	operation	list、element_status、set_element_phases、create_phase_filter、edit_phase_filter、rename_phase、create_phase、assign_design_option
horizun_manage_assemblies_parts	operation	list、create_parts、divide_parts、exclude_parts、restore_parts、dissolve_parts、create_assembly、assembly_views、disassemble
horizun_manage_styles	operation	list_object_styles、set_object_style、create_subcategory、list_line_styles、create_line_style、list_line_patterns、create_line_pattern、list_fill_patterns、create_fill_pattern
horizun_manage_units	operation	read、set、project_information、base_points
horizun_manage_views	operation	create_floor_plan、create_ceiling_plan、create_structural_plan、create_area_plan、create_3d、create_drafting、create_section、create_elevation、create_callout、duplicate_view、apply_template、set_phase、assign_scope_box、set_view_range、set_crop、set_annotation_crop、create_sheet、create_placeholder_sheet、convert_placeholder_sheet、duplicate_sheet、place_view、place_schedule、set_viewport_type、align_viewports、create_filter、apply_filter、color_by_value、set_element_overrides、hide_elements、isolate_elements、reset_temporary、set_category_visibility、create_legend、place_legend_component、edit_filter、order_filters、explain_graphics、create_template、set_template_controls、sheet_set_list、sheet_set_create、sheet_set_update、sheet_set_delete、renumber_sheets、create_perspective、set_sun_study
horizun_manage_views	mode	center、center_x、center_y、left、right、top、bottom
horizun_plan_views	operation	room_views、deliverable_set、delivery_open、delivery_status、delivery_record、delivery_approve、delivery_invalidate
horizun_query_planimetry	mode	inventory、sheets、views、placements、annotations、references
horizun_fix_planimetry	operation	set_view_template、set_view_scale、rename_view、rename_sheet、place_title_block、move_viewport、move_schedule、clear_element_override、set_crop、set_view_display
horizun_plan_annotations	operation	auto_tags、intent_dimension、dimension_set、auto_dimension_grids、auto_dimension_levels、auto_dimension_curtain_walls、auto_dimension_openings
horizun_annotate	operation	text、tag、dimension、angular_dimension、radial_dimension、diameter_dimension、arc_length_dimension、spot_elevation、spot_coordinate、spot_slope
horizun_query_detail_2d	mode	resources、elements
horizun_detail_2d	operation	create_detail_line、create_detail_arc、create_detail_polyline、create_filled_region、create_masking_region、place_detail_component、place_symbol、set_line_style
horizun_manage_revisions	operation	create_revision、update_revision
horizun_manage_schedules	operation	create、duplicate、rename、add_fields、remove_fields、set_field、set_filters、set_sorting、set_options
horizun_manage_schedules	kind	material_takeoff、sheet_list、view_list、revision_schedule、keynote_legend
horizun_cad_connect	fitting	direct、elbow、tee、cross、transition、none
horizun_manage_cad_links	operation	list、add、reload、repoint
horizun_query_cad	mode	instances、layers、geometry、coverage、profile、blocks
horizun_connect_mep	operation	connect、disconnect
horizun_coordination	operation	list、update、export、import、import_navisworks、show、evidence、navisworks_readiness、prepare_navisworks、navisworks_status
horizun_manage_links	operation	list、visible_elements、unload、reload、pin、unpin、add、add_instance、change_path、acquire_coordinates、scan_deviation
horizun_manage_links	kind	rvt、point_cloud、ifc
horizun_plan_mep	operation	route_run、network_census、system_analysis
horizun_plan_mep	kind	pipe、duct
horizun_plan_structure	operation	columns_on_grid_intersections、beams_along_grids
horizun_query_structure	mode	members、hosts、covers、rebar、reinforcement_systems、connections、coverage、quantities、analytical、loads、reconcile、bending_schedule、parse_notation、compare_bars、steel_review
horizun_mep_routing	operation	read、set_rules、add_sizes、remove_sizes、resize、slope、size_by_flow、route、hangers
horizun_mep_routing	kind	pipe、duct、conduit、cable_tray
horizun_mep_routing	action	add、remove、move
horizun_electrical	operation	list_panels、list_circuits、create_circuit、assign_panel、add_to_circuit、remove_from_circuit、panel_schedule
horizun_resolve_clash	operation	propose、apply、propose_opening、apply_opening
horizun_framing	operation	wall、ceiling、read、remove
horizun_manage_groups	operation	list、find_duplicates、annotation_report、create、add_members、remove_members、rename_type、duplicate_type、swap_type、change_group_type、set_group_level、place_group、ungroup、convert_to_link
horizun_manage_worksets	operation	list、create、rename、move_elements、set_default、visibility
horizun_quantities	mode	volume、takeoff、room_finishes、carbon
horizun_budget_compare	operation	compare、export_bc3
horizun_catalog_lookup	operation	leaf、search、bsdd_search、bsdd_search_dictionary、bsdd_class、bsdd_property、bsdd_dictionaries
horizun_link_schedule	operation	import、match、write、status_view
horizun_execute_plan	kind	plan、section、elevation
horizun_promote_script	operation	list、show、propose、review、approve、activate、deactivate、source、resolve、invocation
horizun_run_procedure	operation	start、advance、decide、record、reconcile、status、abandon
horizun_project_context	operation	schema、validate、questions、draft、elicit、ids_from_loin、integrations、register_model、resolve_model
horizun_exchange	operation	emit、verify、correction_plan_check、correction_plan_reverify
horizun_exchange	kind	coordination.ledger、coordination.status、quantities.rows、schedule.element_4d、model.element_lineage、receipt
horizun_information_container	operation	name、stamp、verify、inspect、transition、transmittal、record_review、register
horizun_cde_cloud	operation	list_projects、list_states、inspect、versions、issues_list、issue_create、issue_update
其他类型化选项包括七个 horizun_export.format 值：
pdf、dwg、ifc、nwc、fbx、image、schedule_csv。架构清单还记录了
所有属性和路径中1653 个枚举参数实例；该数字包含配置选项和重复路径，因此不会用作工具数量。

可扩展性、权限和工具发现

组合新工作流： horizun_execute_plan 可使用先前结果和命名依赖项连接最多 100 个类型化操作，并支持 TransactionGroup 回滚。任务专用的项目标准、目录和 CAD 解读规则均可作为输入。 扩展以执行自定义 Revit API 工作： 所有者可启用 horizun_execute_python，以运行由客户端生成的 Python，包括标准库、预检和结构化脚本证据。Python 启用/禁用授权会持续生效，直到被撤销。 Python 结果仍由其自身报告，host_verified: false。

以下配置是在隔离的设置目录中，针对相同的 1.3.3 服务二进制文件，通过实际 MCP tools/list 调用测得的：

配置和工具包	公布的工具数	原因
safe_write，所有工具包，Python 关闭	70	默认的模型内工作配置；外部效果工具会被筛除
full_write，所有工具包，Python 关闭	79	增加文件、导出、文档及其他外部效果操作
unsafe_code，所有工具包，Python 启用	80	完整工具目录，包含自定义 Python
safe_write，仅 core	4	有意精简的连接和作业管理工具集

会话公开的工具较少，也可能是针对特定任务正确配置的结果。在将会话与完整工具目录进行比较之前，请检查 horizun_health 和 horizun://security/current-profile 资源。权限由所有者控制；评估人员无需启用任意代码即可读取工具目录。

对于支持这些功能的客户端，服务还提供标准 MCP 资源、提示词、补全、日志记录和持久任务。资源公开编译后的工具契约、构建标识、有效配置和 BIM 工作流指南。命名提示词涵盖族配方、房间文档、审计和交付。这些协议功能和工作流提示词不计入工具数量。 tools/list 架构经过精简；精确架构位于 horizun://contract/tools/{tool}（对于一种 create_elements 类型或一个 document_session 操作，则为 .../{tool}/{variant}）。违反架构的调用失败时，会指出失败路径和该 URI（如果回复为结构化内容，则包含 structuredContent.schema_help）（详情）。

工具包、精简/摘要查询、选定字段投影和持久作业有助于管理上下文和长时间运行的工作。调用使用有界的 16 槽 FIFO 队列；排队的工作可在执行前取消。长时间运行的操作会提供持久作业 ID 和可读状态。架构。

在 Revit 中测试：已发布版本的实测证据

v1.3.3 于 2026-09-15 发布，包含针对已安装服务及全部五个受支持 Revit 年份的实时发布门禁报告。报告共计 1,230 次探测执行通过：每个年份 246 次，该测试套件中失败、未验证或未覆盖的探测均为 0。每份报告都标明了发布提交、二进制文件哈希和测试框架。发布资源。

Revit	通过	失败	未验证	此套件中未覆盖	报告
2023	246	0	0	0	JSON
2024	246	0	0	0	JSON
2025	246	0	0	0	JSON
2026	246	0	0	0	JSON
2027	246	0	0	0	JSON

这是在五个 Revit 版本上执行的同一套发布测试。它是维护者针对这些测试案例提供的证据，并不代表 1,230 项不同功能，也不是与其他产品的对比。机器可读的证据索引记录了来源 URL 和哈希。持续运行的 GitHub CI 会检查核心/服务行为、Windows 部署、清单与文档的一致性，以及 CodeQL。

公开发布历史始于 2026-08-02 发布的 v0.5.0， 包含 2026-08-26 发布的 v1.0.0， 截至 2026-09-15，共包含 16 个已发布的非预发布版本。 上方的 GitHub 星标徽章显示当前社区数量；公开的 发布历史 和提交历史 可直接反映维护情况。

版本与兼容性

问题	权威来源
最新稳定版下载	GitHub 最新发布版本，包括其发布日期和资源
此源代码检出的版本	Directory.Build.props
实际加载的版本	horizun_health：版本、提交、Revit 年份和活动文档
实现的 MCP 协议	2025-11-25，较早的修订版本列于 ProtocolNegotiation.cs
已发布的注册表元数据	官方注册表条目

对 MCP 2026-07-28 的支持尚待推出。近期发布的产品版本并不意味着支持该协议修订版本。注册表快照和搜索结果摘录可能滞后；选择版本前请查看发布信息。升级已安装的版本时，请关闭 Revit 后运行新版 Setup。

范围与更多参考资料

类型化结果会标明验证状态、部分结果和覆盖范围。未加载的链接以及不受支持的 API/模板/导出器案例都会明确报告。有关各项操作的具体边界，请参阅 TOOLS.md 和 族范围。基准测试方法区分历史设计评分与实时执行证据。

从源代码构建 · 参与贡献 · Agent 说明 · LLM 摘要 · 安全性 · 隐私 · 发布政策

学会指挥

Horizun Hub 用西班牙语讲授如何在真实的建筑与设计工作中指挥 AI Agent，以及如何在签字前审核它们交付的成果。本 MCP 的课程是 Opera agentes en Revit：聚焦真实建筑工作的短课程，并提供可验证的证书。

刚接触 Agent？Opera agentes de IA desde cero 的第 1 级可免费学习，只需注册账户。

由哥伦比亚 🇨🇴 开发，并由 Horizun Group 作为 Horizun Hub 的一部分维护。该桥接工具不依赖特定组织； 项目标准和目录由用户提供。可选的 标准包提供可编辑示例。

Apache-2.0： LICENSE、NOTICE、第三方声明。 不重新分发 Revit API。Autodesk 和 Revit 是 Autodesk 的商标； 本项目与 Autodesk 无关，也未获其认可或赞助。