内容
<div align="center">
<img src="https://img.shields.io/badge/Revit-2027-0070AD?style=for-the-badge&logo=autodesk&logoColor=white"/>
<img src="https://img.shields.io/badge/Claude-MCP-D97757?style=for-the-badge&logo=anthropic&logoColor=white"/>
<img src="https://img.shields.io/badge/Tools-150%2B-7B2D8B?style=for-the-badge"/>
<img src="https://img.shields.io/badge/Version-0.5.0-2EA043?style=for-the-badge"/>
<img src="https://img.shields.io/badge/Windows-10%2F11-0078D4?style=for-the-badge&logo=windows&logoColor=white"/>
<br/><br/>
# Revit 2027 MCP
**Claude MCP 与 Autodesk Revit 2027 集成**
直接向 Claude 暴露 150 多种 Revit API 工具 - 查询、创建、修改、导出、冲突检测以及使用自然语言自动化您的 BIM 模型。
> *"将 MCP 视为 AI 的 USB-C 接口 - 一个连接所有设备的标准。"*
</div>
---
## 📋 目录
| # | 章节 | 描述 |
|---|---------|-------------|
| 🏗️ | **架构** | Claude 如何通过 MCP 连接到 Revit |
| ⚙️ | **需求与安装** | 先决条件和一键安装 |
| 🔧 | **150 多种工具** | 按类别划分的完整功能参考 |
| ✅ | **Claude 可以执行的操作** | 读取、分析、修改、自动化 |
| ⚠️ | **已知限制** | 开始前需要了解的约束 |
| 💬 | **提示策略** | 模板、角色设置、快捷键 |
| 🚀 | **使用案例** | 按学科划分的实际示例 |
| 🌐 | **资源** | 链接、文档、社区 |
---
## 🏗️ 架构
```
Claude (MCP 客户端)
↕ stdio
rvt-mcp.exe (MCP 服务器 - .NET 8 自包含)
↕ HTTP / 命名管道
RvtMcp.Plugin.dll (Revit 加载项)
↕ Revit API
.rvt 模型
```
**流程：** ① 用户编写自然语言 → ② Claude 选择合适的 MCP 工具 → ③ 服务器翻译为 Revit API 调用 → ④ 加载项在 Revit 中运行 → ⑤ 结果流回 Claude
> Claude 绝不会直接触摸 Revit - 它会发送结构化命令，由加载项解释并在 Revit 的 API 中运行。
---
## ⚙️ 需求
| 需求 | 详情 |
|-------------|---------|
| **Revit** | Autodesk Revit 2027 |
| **操作系统** | Windows 10 / 11 x64 |
| **Claude** | Claude Desktop 或带有 MCP 支持的 Claude Code |
---
## 🚀 快速入门
```powershell
.\install.ps1
```
自动部署 - 无需管理员权限：
| 目的地 | 内容 |
|-------------|----------|
| `%APPDATA%\Autodesk\Revit\Addins\2027\RvtMcp\` | 加载项清单 + DLL |
| `%LOCALAPPDATA%\RvtMcp\rvt\server\0.5.0\` | MCP 服务器 exe |
---
## 🔌 Claude MCP 配置
添加到 `~/.claude.json` 下的 `mcpServers`：
```json
"rvt-mcp": {
"command": "C:\\Users\\<user>\\AppData\\Local\\RvtMcp\\rvt\\server\\0.5.0\\rvt-mcp.exe",
"args": []
}
```
**验证连接：**
1. 打开 Revit 2027 - 加载项在启动时自动加载
2. 在 Claude 中运行：`get current view info` - 应该返回 Revit 模型状态
3. 检查 `%LOCALAPPDATA%\RvtMcp\revit-mcp.log` 如果出现问题
---
## 🔧 150 多种可用工具
<details>
<summary><strong>🔍 查询和模型信息</strong></summary>
`get_current_view_info` · `get_element_details` · `get_element_parameters` · `get_element_bounding_box` · `get_element_geometry` · `get_element_relationships` · `ai_element_filter` · `analyze_model_statistics` · `get_model_warnings_summary` · `get_selected_elements` · `get_family_instances` · `get_available_family_types` · `list_loaded_families` · `list_materials` · `list_rooms` · `list_sheets` · `list_schedules` · `list_views` · `list_phases` · `list_worksets` · `get_current_target`
</details>
<details>
<summary><strong>✏️ 创建元素</strong></summary>
`create_wall` · `create_floor` · `create_room` · `create_level` · `create_grid` · `create_view` · `create_sheet` · `create_schedule` · `create_dimensions` · `create_text_note` · `create_detail_line` · `create_structural_column` · `create_structural_beam` · `create_structural_wall` · `create_foundation_isolated` · `create_foundation_wall` · `create_rebar_set` · `create_rebar_stirrup` · `create_duct` · `create_pipe` · `create_cable_tray` · `create_conduit` · `create_air_terminal` · `create_lighting_fixture` · `create_material` · `create_revision`
</details>
<details>
<summary><strong>🔄 修改和自动化</strong></summary>
`assign_material_to_element` · `apply_view_template` · `override_element_graphics` · `set_parameter_value_by_guid` · `set_view_scale` · `set_view_crop` · `set_view_phase` · `set_category_visibility` · `set_element_phase` · `rename_family_type` · `duplicate_family_type` · `replace_family_type` · `renumber_sheets` · `batch_execute` · `send_code_to_revit`
</details>
<details>
<summary><strong>📤 导出</strong></summary>
`export_pdf` · `export_dwg` · `export_ifc` · `export_nwc` · `export_dwf` · `export_fbx` · `export_gbxml` · `export_dgn` · `export_image` · `export_schedule_csv` · `export_elements_data` · `export_room_data` · `batch_export_sheets`
</details>
<details>
<summary><strong>🔎 冲突和质量控制</strong></summary>
`clash_detection` · `find_overlapping_elements` · `find_elements_in_volume` · `find_untagged_elements` · `find_undimensioned_elements` · `find_mep_disconnects` · `get_model_warnings_summary` · `audit_families` · `purge_unused`
</details>
<details>
<summary><strong>📐 MEP 和结构</strong></summary>
`analyze_mep_network` · `connect_mep_elements` · `get_mep_element_connectors` · `get_panel_schedule` · `list_mep_systems` · `get_system_inventory` · `get_structural_loads` · `set_structural_load` · `analyze_structural_connections`
</details>
<details>
<summary><strong>🧰 工作流程和内置工具</strong></summary>
`workflow_clash_review` · `workflow_model_audit` · `workflow_sheet_set` · `workflow_view_cleanup` · `workflow_room_documentation` · `workflow_naming_normalization` · `workflow_takeoff_report` · `workflow_data_roundtrip` · `list_baked_tools` · `run_baked_tool`
</details>
---
## ✅ Claude 在 Revit 中可以执行的操作
**读取和查询**
- 按类别、类型、级别或参数查询任意元素
- 获取模型元数据 - 文件路径、版本、项目信息
- 导航视图 / 图纸 / 级别层次
- 访问所有内置和共享参数
**分析和报告**
- 按任意筛选条件统计和聚合元素
- 在聊天中生成格式化 HTML 表格
- 检测命名标准违规
- 跨阶段比较元素集
**修改和自动化**
- 通过 Revit API 创建、移动和删除元素
- 批量更新数百个元素的参数
- 按比例重命名视图、图纸和族
- 在 Revit 中执行自定义 C# 或 Python 代码
---
## ⚠️ 已知限制
| 限制 | 详情 |
|-------|---------|
| **无视觉访问** | Claude 无法看到 3D 视图或截图 - 交互纯粹基于数据驱动 |
| **复杂几何体** | 自由曲面和复杂实体操作通常失败 |
| **代码审查要求** | AI 生成的 C# 代码在运行生产模型之前必须审查 |
| **仅限 Claude Desktop** | MCP 需要 Claude Desktop 或 Claude Code - 网页版不支持 MCP |
| **Revit API 边界** | 一些只读上下文阻止写入；Claude 受与任何加载项相同的规则约束 |
| **提示精度** | 模糊的提示会导致错误的工具调用 - 具体的提示会显著提高准确性 |
---
## 💬 提示策略
### 1️⃣ 首先设置 BIM 专家角色
以此系统提示开始每个会话:
```
您是 Revit 2027 中的 BIM 专家。
仅使用可用的 MCP 工具，并在进行大型编辑之前确认。
```
这会显著提高工具选择准确性并防止意外写入。
---
### 2️⃣ 推荐的会话工作流程
```
1. 打开 Revit 项目（活动模型 = Claude 读取的内容）
2. 在 Claude 中设置角色（上述 BIM 专家提示）
3. 定位模型 → "这个模型是什么？列出级别、学科、主要元素数量。"
4. 运行有针对性的查询 → 具体、过滤后的读取首先
5. 谨慎执行编辑 → 始终在批量写入之前询问预览
6. 导出结果 → HTML 或 JSON 报告；Claude 在会话之间没有内存
```
---
### 3️⃣ 提示快捷键
| 任务 | 模板 |
|------|----------|
| **按筛选条件列出** | `列出 [类别] 在 [级别] 上，其中 [参数] = [值]` |
| **计数和聚合** | `按 [参数] 分组计算 [类别] - 以表格形式输出` |
| **合规检查** | `查找所有 [类别] 其中 [参数] 为空或缺失` |
| **批量更新** | `将 [参数] = [值] 设置为所有 [类别] 类型 [类型] - 先显示给我` |
| **系统化重命名** | `使用模式 [格式] 重命名所有 [类别] 视图` |
| **HTML 报告** | `生成 [类别] 的 HTML 报告，包括列：[参数]` |
| **JSON / CSV 导出** | `以逗号分隔的行导出所有 [类别] 及 [参数]` |
| **图纸设置** | `为所有 [视图类型] 视图创建图纸，按 [格式] 编号` |
> **提示：** 始终在确认任何写入之前附加“显示我将更改的内容”。对于批量编辑，请让 Claude 先列出元素 ID，然后再确认。
---
### 4️⃣ 按用例划分的真实提示示例
<details>
<summary><strong>🏛️ 模型审计和数据提取</strong></summary>
```
列出 1 级的所有墙 - 显示类型名称、长度和耐火等级参数。
标记任何耐火等级为空的行。
```
```
模型中有多少个门，它们服务于哪些房间？
按房间名称分组。
```
```
显示制造商参数为空的所有族。
```
</details>
<details>
<summary><strong>🔧 MEP 质量控制和标准检查</strong></summary>
```
查找所有房间没有面积或缺少房间编号的房间。
返回不符合项列表，附带元素 ID。
```
```
检查所有管道系统是否填写了系统缩写参数。
返回按系统类型排序的通过/失败表格。
```
```
列出模型中所有未连接的管道端点。
```
</details>
<details>
<summary><strong>📄 图纸设置和文档</strong></summary>
```
为每个平面视图创建图纸并编号为 A-101、A-102...
在提交前确认图纸数量。
```
```
生成所有图纸的 HTML 报告：编号、名称、放置的视图和修订日期。
```
```
将所有剖面视图从“Sec X”格式重命名为“SEC-[编号]-[级别]”。
```
</details>
<details>
<summary><strong>🔄 批量参数更新和族管理</strong></summary>
```
将制造商 = “ACME Corp”设置为所有 W 型结构柱。
返回更新后的计数。
```
```
查找所有标记为空的门并自动按房间字母顺序编号。
使用格式 D-001、D-002...
```
```
列出重复的族名称并建议合并。
按命名相似性分组并提出审批计划。
```
</details>
<details>
<summary><strong>🏗️ 结构查询和调度</strong></summary>
```
列出所有结构梁，按材料分组并汇总每个组的长度。
输出为材料提取摘要。
```
```
哪些柱子的基准标高与所在楼层的标高不同超过 200mm？
```
```
生成所有基础及其承载能力参数的 JSON 输出。
```
</details>
<details>
<summary><strong>🔍 协调审查和模型健康检查</strong></summary>
```
查找根据以下规则放置在错误工作集上的所有元素：
- 墙 → A-Shell 工作集
- MEP → M-设备 工作集
标记不符合的元素。
```
```
显示模型中目前的所有警告消息，按类型分类。
按频率优先排序。
```
```
列出所有穿越 3 级边界的机械管道元件，无需正确偏移。
```
</details>
<details>
<summary><strong>📊 智能报告和数据导出</strong></summary>
```
创建房间数据表为 HTML 报告。
包括：房间名称、编号、面积、装修、部门。
使用斑马行样式，可按部门排序。
```
```
生成门按楼层分组的门窗表，显示数量、类型和耐火等级。
格式化为 HTML 表格。
```
```
导出所有元素 ID 及其参数为逗号分隔的行。
包括表头。 格式化为 Excel 导入。
```
</details>
---
## 📁 文件
| 路径 | 用途 |
|------|---------|
| `addin/RvtMcp.R27.addin` | Revit 加载项清单 |
| `addin/RvtMcp.Plugin.dll` | 主要加载项程序集 |
| `addin/*.dll` | 依赖项（SQLite、Newtonsoft.Json 等） |
| `server/rvt-mcp.exe` | MCP 服务器 exe（自包含 .NET 8，98 MB） |
| `server/RvtMcp.Server.pdb` | 调试符号 |
| `revit-2027.json` | Revit 2027 模型元数据快照 |
| `install.ps1` | 一键安装脚本 |
---
## 🌐 资源
| 资源 | 链接 |
|----------|------|
| Anthropic MCP 文档 | https://docs.anthropic.com/mcp |
| MCP 规范 | https://modelcontextprotocol.io |
| Claude Desktop 下载 | https://claude.ai/download |
| Revit API 文档 | https://revitapidocs.com |
---
## 👤 致谢
研讨会材料和提示策略改编自 **“Revit × Claude MCP 研讨会”** 幻灯片，由 **Abdelrhman Hosny** 提供，BIM/VDC 工程师。
---
<div align="center">
**服务器：`0.5.0` | 加载项：`RvtMcp.R27`（Revit 2027 API） | 工具：150+
*Claude MCP 与 Autodesk Revit 2027 集成*
</div>
