Revit MCP Datum

](https://mseep.ai/app/revit-mcp-revit-mcp)

Revit MCP增强版

一个高级的模型上下文协议（MCP）服务器，用于通过自然语言进行全面的Revit自动化和绘图。增强与 155+强大的工具 为了实现完全的BIM自动化： 建筑的 （结构系统、多层建筑、墙壁、地板、屋顶、楼梯、坡道、幕墙）， 欧洲议会议员 （电路和面板、暖通空调管道和设备、管道和固定装置、消防喷淋系统、负载计算、自动布线）， 能源与可持续性 （能源分析、阳光照射、采光、碳足迹）， 参数化设计 （创建/编辑族、自适应组件）， 设计选项 （变体探索、成本/性能比较）， 成本估算 （数量统计、RSMeans积分）， 结构分析 （分析模型、负载应用）， 高级网站设计 （建筑红线、停车布局、景观美化）， 协调 （碰撞检测、测量、元素关系、相位）， 几何运算 （复制、阵列、镜像、修剪、分割、偏移）， 可视化 （3D视图、组件）， 导入/导出 （CAD、模型链接、PDF/DWG导出）， 材料与参数 （浏览/分配材料、读/写参数）， AI驱动 （布局优化、汽车装饰、代码合规性）， 工作集 （多用户协作）， 模型优化 （清除、审核、压缩），以及 制造 （车间准备好的MEP详图，带卷轴）。

描述

revit-mcp允许您通过mcp支持的客户端（如Claude Desktop、Cline和其他AI助手）使用mcp协议与revit进行交互。

这个项目是 MCP服务器端 （为AI提供工具）。你需要使用 revit mcp插件 （驱动Revit API的Revit插件）。

主要特点

• 人工智能设计分析与验证：深度模型扫描，返回具有精确坐标的结构化问题报告，消除LLM幻觉，并实现精确的校正代码生成
• BIM互操作性：IFC导入/导出（IFC2x3、IFC4、IFC4x3），用于开放式BIM工作流、跨平台协调（Navisworks、Solibri、Tekla、ArchiCAD）和业主移交（COBie）
• 生产文档：用于规范/估算/FM的导出计划（CSV、Excel、JSON），用于标准化100个视图的视图模板，批处理模板应用程序
• 能源与可持续性：能源模拟（ASHRAE 90.1，IECC）、太阳能暴露分析、采光指标（LEED v4的sDA/ASE）和碳足迹（体现+操作）
• 参数化设计：以编程方式创建和编辑族，复杂立面的自适应组件，人工智能生成的自定义组件
• 设计选项和变体：在一个模型中探索多种设计替代方案，按成本/能源/碳进行比较，人工智能推荐最佳解决方案
• 成本估算：按材料/CSI部门自动计算数量，使用RSMeans集成进行施工成本估算，价值工程
• 结构分析：分析模型生成、负载应用（静、活、风、地震）、导出到有限元分析软件（Robot、SAP2000、ETABS）
• 高级网站设计：经过挫折验证的建筑红线、自动生成的停车布局（符合ADA标准）、树木/家具景观
• 智能家具自动化：房间感知家具摆放、按房间类型自动布置、家具目录浏览和人工智能驱动的布局优化
• 高级绘图工具：自动标注尺寸（9种模式）、绘图视图、图例创建、带自动编号的注释符号、高程点
• 建筑规范合规性：出口、ADA/无障碍、消防安全和空间要求的自动检查（IBC、NBC印度、欧洲规范）
• 布局优化：人工智能驱动的房间布局优化，采用8种策略（空间效率、流通、人体工程学、自然光等）
• 自动对准：检测并纠正错位的墙壁、柱子、门和家具，具有可配置的公差
• 镜像和复制布局：复制房间之间的家具布局，复制不同楼层的平面图
• 工作集和协作：具有工作集管理功能的多用户工作共享，按专业/区域/阶段分配图元
• 模型优化：清除未使用的元素、审核/修复数据库、压缩文件大小、修复警告、识别重族
• 综合数据检索：通过智能过滤从Revit项目中获取详细的空间/几何数据
• 结构体系：梁、桁架、支架、基础（墙/隔离墙/条带/垫）——多层建筑的完整结构框架
• 多层建筑：使用自动间距楼板创建标高，在标高之间复制图元，排列结构间距
• 墙创建：具有堆叠墙、嵌入式墙、定位线控制和层结构配置的专用墙工具
• 绘图自动化：地板（倾斜、结构）、天花板（网格图案、隔板）、屋顶（足迹、挤压）、幕墙、幕墙网格、竖框、楼梯、坡道、栏杆、柱子和开口的专用工具
• 协调与分析：元素关系分析、距离测量、碰撞检测（学科间几何碰撞检测）
• 分期与翻新：创建阶段（现有、拆除、新建），将创建/拆除的阶段分配给图元
• 几何运算：复制、阵列（线性/径向/2D网格）、镜像、分割、修剪/延伸、偏移、连接/取消连接几何图形和组元素——核心绘图效率工具
• 墙体详图：编辑墙轮廓（女儿墙、阶梯式）、墙饰条（飞檐、踢脚板、拱顶饰条）和墙侧边（凹槽线）
• 现场设计：创建地形表面、建筑地坪和场地平整
• 家庭和组件管理：从库中载入族，按类别浏览载入的族目录，并放置具有主体图元支持的构件实例
• 参数和材料：读取/写入任何图元参数、浏览项目材质、按参数指定材质或绘制
• 区域规划：根据BOMA标准创建区域平面图、区域边界并计算可出租/总面积
• 三维视图和可视化：使用相机控制、预设方向、剖面框和显示样式创建透视和正交三维视图
• 导入和链接：导入CAD（DWG/DXF）以供参考，链接Revit模型以进行协调，管理链接模型的定位
• 装配视图：使用自动生成的施工图视图和预制件协调创建施工详图部件
• 出口和文件：将视图导出为PNG、JPEG、PDF、DWG、DXF，具有可配置的分辨率、纸张大小和图层映射
• 电气系统：电路、面板、灯具、导管布线、NEC负载计算——完整的电力和照明设计
• 机械（暖通空调）系统：管道系统、空气处理机组、变风量系统、扩散器、系统定义、ASHRAE负荷计算——完整的暖通空调设计
• 管道系统：管道、固定装置、供水/卫生/雨水系统、固定装置单元计算——完整的管道设计
• 消防：符合NFPA 13标准、自动喷头间距、危险分类的喷水灭火系统
• MEP协调：自动布线，避免碰撞，MEP空间，带卷轴板的预制细节
• 高级元素创建：使用自然语言创建墙、楼板、天花板、屋顶、房间、柱和族
• 完成元件修改：移动、旋转、调整大小、更改类型、翻转、镜像、固定/取消固定和设置参数
• 视图和表管理：自动化视图创建、复制和图纸组织
• 注释自动化：批量标记元素、创建尺寸、添加文字注释和详图线
• 房间和空间规划：创建和管理具有自动面积计算功能的房间
• 网格和参考系统：创建轴网、参照平面、模型线和标高管理
• 视觉控制：对元素进行颜色编码、设置透明度、隔离、隐藏和高亮显示
• 空间验证：检查间隙、重叠、相邻和无障碍合规性
• AI生成的代码执行：将自定义代码发送到Revit进行复杂操作

需求

• 节点 18+

完整的安装环境还需要考虑revit mcp插件的需求，请参考 revit mcp插件

⚡ 快速设置（5分钟）

自动设置（推荐）

窗户：

./quick-setup-secure.bat

Linux/Mac：

chmod +x quick-setup-secure.sh
./quick-setup-secure.sh

这个自动生成您的API密钥，创建证书，并配置一切！

生成什么

运行安装程序后，您将获得：

• ✅ 随机64字符API密钥 -保存在 .env 文件自动
• ✅ SSL证书 -用于安全的HTTPS连接
• ✅ 配置 - .env 包含所有设置的文件

配置Claude桌面

编辑您的Claude配置(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "revit-mcp": {
      "url": "https://localhost:3000",
      "env": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

从获取API密钥 .env 由安装脚本创建的文件。

启动服务器

# Option 1: Direct
node server-secure.js

# Option 2: PM2 (Recommended)
npm install -g pm2
pm2 start ecosystem-secure.config.js
pm2 logs revit-mcp-secure

验证连接

# Test health (no auth needed)
curl -k https://localhost:3000/health

# Test with API key
curl -k https://localhost:3000/status -H "X-API-Key: YOUR_KEY_FROM_.env"

______________________________________________________________________

🔐 安全特性

✅ API密钥验证 -所有请求都需要有效的API密钥\ ✅ HTTPS/TLS -加密通信\ ✅ IP白名单 -可选，受网络限制\ ✅ 速率限制 -100个请求/分钟（可配置）\ ✅ 默认本地主机 -默认情况下为零公开曝光

看 START_HERE.md 更多选择。

框架

flowchart LR
	CladueDesktop --> revit-mcp --> SocketService--commandName-->CommandlSet--command-->CommandExecute
	CommandManager --> CommandlSet
	CommandExecute --executeResult--> SocketService
	CommandProject1 --> CommandManager
	CommandProject2 --> CommandManager
	CommandProject... --> CommandManager
	subgraph ide1 [MCPClient]
	CladueDesktop
	end
	subgraph ide2 [MCPServer]
	revit-mcp
	end
	subgraph ide3 [Revit]
			subgraph ide3.1 [revit-mcp-plugin]
				SocketService
				CommandlSet
				CommandManager
				CommandExecute
			end
	end

支持的工具（155+）

🧠 人工智能设计分析与验证 *新*

这些工具通过提供地面真实模型数据来消除LLM幻觉。始终运行 analyze_layout_design 在做出设计决策之前。

🪑 家具与布局自动化 *新*

📐 注释和绘图工具 *（扩展）*

📊 数据检索与查询

🏗️ 元素创建（通用）

🧱 墙创建 *新*

🏢 绘图自动化——地板、天花板和屋顶 *新*

为每种元素类型提供全参数支持的专用工具。这些通过暴露坡度、结构特性、网格图案、悬挑等，远远超出了基于通用曲面的创建。

🔲 幕墙系统 *新*

完成幕墙工作流程：创建墙，配置网格，然后放置竖梃。每个工具都提供对幕墙构件的精细控制。

🪜 楼梯、坡道和栏杆 *新*

具有建筑规范意识的全垂直流通工具。楼梯自动计算从楼层到楼层高度的立管数量。坡道支持ADA坡度合规性。栏杆可以是独立的，也可以安装在楼梯/坡道上。

🏛️ 列 *新*

🔩 结构体系 *新*

多层建筑的完整结构框架。梁跨在柱之间，桁架支撑屋顶，支架抵抗横向荷载，基础将荷载传递到地面。

📐 多层级管理 *新*

🧱 墙体详图 *新*

内外墙饰面详图。对于生产级建筑图纸至关重要。

🌍 场地和地形 *新*

🔄 几何运算 *新*

核心起草效率工具。复制、阵列、镜像、分割、修剪、偏移和分组——这些操作对于从重复图案高效构建完整设计至关重要。

🎛️ 参数和材料 *新*

读取和写入任何元素属性。对于LLM了解和控制元素特征、分配饰面和制定准确的时间表至关重要。

🔍 分析与协调 *新*

对于人工智能理解模型关系、验证间隙、检测冲突和确保可施工性至关重要。

🏗️ 分期与翻新 *新*

用于改造项目和分期建设。显示现有条件、拆迁和新建筑。

📐 模型几何图形 *新*

📏 区域规划 *新*

📤 出口和文件 *新*

📥 导入和链接 *新*

引入外部参考以进行协调和背景分析。

📦 家庭和组件管理 *新*

这些工具支持LLM辅助的组件选择：首先发现可用的组件（已加载或在库中），然后放置正确的组件。对于人工智能驱动的绘图工作流程至关重要。

______________________________________________________________________

⚡ MEP（机械、电气、管道）系统 *新*

🔌 电气系统 *新*

完整的电气设计：电路、面板、固定装置、导管布线和符合NEC的负载计算。

❄️ 机械（暖通空调）系统 *新*

完整的暖通空调设计：管道系统、设备放置、系统定义和ASHRAE负荷计算。

💧 管道系统 *新*

完整的管道设计：管道、固定装置、系统和固定装置单位计算。

🚨 消防 *新*

消防喷淋系统设计符合NFPA 13标准。

🔧 MEP协调 *新*

MEP空间、自动布线和预制细节。

______________________________________________________________________

🌐 BIM互操作性和生产文件 *新*

📦 IFC进口/出口 *新*

通过IFC（行业基础课程）开放BIM工作流程，IFC是跨平台协调、业主移交（COBie）和多学科协作的通用交换格式。

📊 计划数据导出 *新*

将进度数据导出到外部系统，用于规范、估算、设施管理和人工智能驱动的文档生成。

🎨 查看模板 *新*

使用视图模板对文档进行标准化--立即将图形设置传播到100个视图，执行公司标准，并在标准更改时更新视图。

______________________________________________________________________

⚡ 先进的设计自动化和智能化 *新*

🌱 能源分析与可持续性 *新*

性能驱动设计，包括能源模拟、太阳能分析、采光和碳足迹计算。对于可持续设计、绿色建筑认证（LEED、WELL）和能源法规合规性至关重要。

🔀 设计选项和变体 *新*

在单个模型中探索设计备选方案。人工智能可以生成多种选项（立面系统、结构方案、布局），并对其进行定量比较，以推荐最佳解决方案。

🏗️ 参数化族创建 *新*

以编程方式创建自定义Revit族。AI可以生成定制的组件，而不局限于现有的库。定制家具、专用设备和独特建筑元素必不可少。

💰 数量统计和成本估算 *新*

具有成本意识的设计，具有自动化的材料数量和施工成本估算。对于预算验证、价值工程和成本驱动的设计优化至关重要。

🏗️ 结构分析集成 *新*

桥梁设计和工程，包括分析模型和荷载应用。对于结构验证和与分析软件（Robot、SAP2000、ETABS、STAAD）的协调至关重要。

🌳 高级网站设计 *新*

完成现场规划，包括建筑红线、停车布局和景观美化。对于分区合规性、现场布局优化和外部可视化至关重要。

👥 工作集和协作 *新*

大型项目的多用户协作。按学科、区域或阶段组织模型元素，以实现团队成员和AI驱动的元素组织的并发工作。

⚙️ 模型优化与维护 *新*

保持模特的健康和表现。在人工智能驱动的批量元素创建之后，这是必不可少的，可以防止模型膨胀并保持响应能力。

📍 高级注释 *新*

带有点高程和点坐标的施工文件。

______________________________________________________________________

👁️ 视图管理

📄 图纸和视口管理

📏 网格和参考系统

🏠 房间和空间管理

📊 进度表和分析

🎨 详细组件

📝 修订和文件

✏️ 元件修改和操作 *（扩展）*

🔧 高级工具

💾 数据持久层

______________________________________________________________________

AI设计分析工作流程

这 analyze_layout_design 该工具是精确的人工智能驱动设计审查的基石。以下是它如何消除幻觉并实现精确矫正：

flowchart TD
    A[User asks AI to review/modify design] --> B[analyze_layout_design]
    B --> C{Structured Report}
    C --> D[elements: All elements with exact coordinates]
    C --> E[issues: Overlaps, misalignment, missing elements, code violations]
    C --> F[statistics: Summary counts and metrics]
    C --> G[spatial_map: Room-element relationships]
    E --> H[Each issue has: severity, elementIds, coordinates, suggestedFix]
    H --> I[LLM generates targeted correction code]
    I --> J{Apply via}
    J --> K[modify_element - move/rotate/resize]
    J --> L[send_code_to_revit - complex C# operations]
    J --> M[auto_align_elements - fix misalignment]
    J --> N[place_furniture_in_room - fix furniture]
    K & L & M & N --> O[validate_spatial_relationships]
    O --> P{All clear?}
    P -->|Yes| Q[Design validated]
    P -->|No| B

为什么这可以防止幻觉

人工智能助理的推荐工作流程

建筑阶段：

1. 设置级别：使用 create_level 和 autoSpaceFloors 建立多层结构
2. 分析现有模型：呼叫 analyze_layout_design 和 analysisScope: "full" 在进行更改之前
3. 了解关系：使用 get_element_relationships 在修改之前了解主机/托管依赖关系
4. 获取空间数据：使用 get_element_spatial_data 用于精确坐标； get_element_parameters 对于房产
5. 发现组件：使用 get_loaded_families 或 load_family 查找可用的家庭类型
6. 构建结构：使用 create_column, create_beam, create_foundation 结构体系
7. 创建机柜：使用 create_wall, create_floor, create_roof, create_curtain_wall，和开口
8. 内部细节：使用 create_ceiling, create_stairs, create_railing, create_wall_sweep 用于饰面
9. 跨级别复制：使用 copy_elements 在各个级别之间， array_elements, mirror_elements 为了效率
10. 分配材料和阶段：使用 get_project_materials + set_element_material 用于饰面； manage_phases + set_element_phase 用于装修

MEP阶段： 11\. 定义MEP空间：使用 create_mep_space 用于机械室、电气室、竖井 12\. 计算负载：使用 calculate_hvac_load 对于HVAC尺寸， calculate_electrical_load 用于面板尺寸 13\. 放置设备：使用 place_mechanical_equipment （aHUS、vavs）， place_electrical_equipment （面板）， place_plumbing_fixture （水槽、厕所） 14\. 路线分布：使用 create_duct, create_pipe, route_conduit，或 route_mep_path 用于自动路由 15\. 创建系统：使用 create_mechanical_system, create_plumbing_system, create_electrical_circuit 组织设备 16\. 增加消防：使用 create_sprinkler_system NFPA自动布局

协调和文件： 17\. 协调和验证：运行 detect_clashes （尤其是纪律与纪律）， measure_distance, validate_spatial_relationships，以及 check_building_code_compliance 18\. 制造细节：使用 create_mep_fabrication 适用于带卷轴板的车间准备MEP 19\. 创建视图：使用 create_3d_view 为了演示， create_assembly 了解施工细节 20\. 文件和导出：使用 export_view 生成可交付成果（PDF、DWG、图像）

完整的多层建筑工作流程（新）

flowchart TD
    A[Start: Multi-Story Building] --> B[create_level — autoSpaceFloors]
    B --> C[create_grid — Structural grid layout]
    C --> D[create_column — At grid intersections]
    D --> E[create_beam — Between columns]
    E --> F[create_foundation — Under columns/walls]
    F --> G{Create per-level elements}
    G --> G1[create_floor — Each level slab]
    G --> G2[create_line_based_element — Walls]
    G --> G3[create_curtain_wall — Facade]
    G3 --> G3a[create_curtain_grid] --> G3b[create_mullion]
    G --> G4[create_stairs + create_railing]
    G --> G5[create_ramp + create_railing]
    G1 & G2 & G3b & G4 & G5 --> H[copy_elements BetweenLevels — Repeat to all floors]
    H --> I{Interior Detailing}
    I --> I1[create_ceiling — Grid/bulkhead]
    I --> I2[create_room + auto_furnish_room]
    I --> I3[create_wall_sweep — Baseboards, cornices]
    I --> I4[create_opening — Doors, windows, shafts]
    I1 & I2 & I3 & I4 --> J[create_roof + create_truss]
    J --> K[set_element_material — Apply finishes]
    K --> L[validate_spatial_relationships]
    L --> M[check_building_code_compliance]
    M --> N[export_view — PDF/DWG deliverables]