cad2revit-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cad2revit-mcp parse floor_plan.dxf, detect columns and walls, then list any ambiguous ones"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
cad2revit-mcp
把二维结构 CAD 图纸转换成 Revit 三维模型的 MCP 工具。定位是让大语言模型通过 MCP 做「二维翻三维」的翻模:模型负责看图、判断和处置疑点,工具负责确定性的几何处理、规则识别与建模执行。
现状:
0.2.1。新增构件图关系层(query_graph)与转换链路规格;识别与执行链路可端到端跑通,执行层以「本地模拟 + Revit 参考 Add-in」两种形态提供,尚未在真实 Revit 项目上完成验收。请勿直接用于交付级生产。
它解决什么问题
结构专业从 CAD 平面图翻到 Revit,重复劳动集中在四件事:看图找柱墙梁、抄截面尺寸、对齐轴网标高、逐个建构件。这个工具把这段工作拆成可校验的流水线:
DXF/DWG → 解析 → 规则识别(带证据+置信度) → 构件图(轴网锚点/支座/重叠) → 疑点裁决 → 指令生成 → Revit 执行 → 回验 → 报告其中「看图—裁决」交给大语言模型通过 MCP 工具调用完成;「指令生成—执行—回验」是纯确定性代码,保证同样输入得到同样结果。图关系与阈值见 docs/graph-model.md,每一跳的接口形态见 docs/conversion-pipeline.md。
Related MCP server: RevitMCP
能力边界(先看这里)
支持 | 不支持 |
结构专业:轴网、柱、墙、梁 | 建筑装修、机电、钢筋、节点详图 |
DXF(内置解析) | DWG 需自备转换器(ODA/AutoCAD CLI),否则 |
图纸内文字标注(TEXT/MTEXT) | 扫描件、图片、PDF 图纸;OCR 属后续版本 |
逐构件证据与置信度、人工裁决 | 全自动交付、无人值守批量出图 |
本地模拟执行 + Revit 桥接参考实现 | 独立 UI(本工具是 MCP 服务,由客户端承载界面) |
安装
需要 Python 3.10+。
git clone https://github.com/lizhengyang-byte/cad2revit-mcp.git
cd cad2revit-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .依赖:mcp>=1.0,<2、ezdxf、shapely。mcp 2.x 已把 FastMCP 改名为 MCPServer,本版仍用 1.x API,因此上限锁在 <2;直接用 pip install cad2revit-mcp 也一样受此约束。
安装后验证:
cad2revit-mcp --version # 0.2.1
cad2revit-mcp --tools # 列出八个工具
cad2revit-mcp --selftest --workspace ./workspace快速跑通(不需要 Revit)
# 生成示例图纸并跑完整流程(安装后无需 PYTHONPATH)
cad2revit-mcp --selftest --workspace ./workspace
# 源码未安装时的跑法
PYTHONPATH=src python -m cad2revit_mcp --selftest --workspace ./workspace
# 启动 MCP 服务(stdio)
cad2revit-mcp自检会在 ./workspace/tasks/<task_id>/ 下留下 parsed/、ir/、script/、run/、check/、report.md,可直接打开报告看识别结果与图关系。
接到 MCP 客户端
{
"mcpServers": {
"cad2revit": {
"command": "/absolute/path/to/cad2revit-mcp/.venv/bin/cad2revit-mcp",
"args": [],
"env": {
"CAD2REVIT_WORKSPACE": "/absolute/path/to/workspace"
}
}
}
}也可继续用 python -m cad2revit_mcp(需将 src 加入 PYTHONPATH)。工作区目录必须先存在;服务不会自行创建白名单之外的路径。
八个工具
工具 | 作用 | 关键约束 |
| 解析图纸,输出图层、文字、图框与体检结论 | 只读;路径必须在白名单内 |
| 识别轴网/柱/墙/梁,输出 IR、构件图与疑点 | 每个构件带 |
| 按构件/关系类型/邻域深度查构件图 | 先看图关系,再裁决 |
| 对疑点执行 accept / modify / exclude | 只改点名构件,不「改一个动一片」 |
| 生成确定性指令集,分批并计算哈希 | 族类型、标高缺失即跳过并告警 |
| 按批执行,失败批次整批回滚 | 幂等键去重,重复执行不重复建模 |
| 与原图比对,查漏、错位、缺参、重复、拓扑 | 默认容差 50mm |
| 导出六段式建模报告 | 目前仅 markdown |
统一返回体:
{
"status": "ok | partial | error",
"data": {},
"warnings": [{"code": "W-1001", "message": "..."}],
"error": null,
"trace_id": "trace-t-20261117-abcd"
}完整入参、出参与数据模型见 docs/mcp-tools.md 与 docs/ir-schema.md。
构件图:让模型看懂「关系」而不是只看到「构件」
detect_components 除构件列表外,还建一张构件图:轴线、轴网交点、柱、墙、梁都是节点,边带类型与数值。
{
"summary": {"headline": "6 个构件,3 条关系,1 个轴网交点,3 个拓扑异常",
"lines": ["柱 C-001,锚点 A-1/A-2 @ (0.0, 0.0),置信度 1.00,关系:位于轴线 A-1(偏移 0.0 mm);位于交点 A-1/A-2"]}
}关系 | 含义 | 发现的问题 |
| 柱落在轴网交点 | 不在交点 → |
| 梁端落在柱/墙 | 两端都无支座 → |
| 墙沿轴线 | 自由墙需复核 |
| 同类构件重叠 | 重复识别 |
| 墙穿柱 | 建模错误 |
拓扑异常不代表工具出错,而是图纸本身有问题,因此只告警(W-1005)并把构件编号交回模型与人工,不阻断建模;同时它们会并入 ambiguous,强制模型显式裁决。
架构
src/cad2revit_mcp/
├── server.py # 八个 MCP 工具
├── pipeline.py # 解析→识别→建图→裁决→规划→执行→回验→报告
├── models.py # IR 与几何数据结构
├── config.py # 白名单、阈值、族与标高映射
├── errors.py # 错误码与统一返回体
├── store.py # SQLite:任务、疑点、批次、幂等键
├── geometry.py # 平行、重叠、闭合、面积等纯函数
├── samples.py # 示例图纸生成(--selftest 用)
├── rules/ # 随包分发的规则 JSON
└── engine/
├── parser/ # ezdxf 解析与单位归一
├── detector/ # 规则库 + 四类构件识别与置信度
├── graph.py # 构件图:轴网交点、关系边、拓扑异常、模型摘要
├── resolver.py # 裁决落库与 IR 更新
├── planner.py # 指令生成、批次、映射校验、关系随行
├── executor.py # Revit 桥接 / 本地模拟、幂等、快照
├── verifier.py # 模型回验(含拓扑)
└── reporter.py # 六段式报告设计取舍与数据流见 docs/architecture.md。
识别是怎么做的
规则而不是「猜」:
图层语义:图层名正则匹配(
KZ/QT/KL/AXIS/轴线等),命中记layer_weight。几何约束:柱看闭合多段线或图块包围盒;墙看平行线间距(60–400mm)与重叠长度;梁看梁线长度与标注距离;轴网看贯穿长度。
文字证据:就近取标注,解析
600x600、250x600这类截面;标注与几何矛盾时扣分并生成疑点。置信度:
0.5×图层 + 0.3×几何 + 0.2×标注,冲突扣0.25。默认阈值0.75,低于阈值的构件全部进疑点清单,不会静默建模。
规则库是可替换的 JSON:rules/structure_default.json。构件图阈值在同文件的 graph 段;包内另有一份运行时副本(src/cad2revit_mcp/rules/),两者由用例保证一致。
Revit 侧
revit_addin/ 是一份 C# 参考实现:在 Revit 里起本地 HTTP 端点,接收批次指令,一个 Transaction 内创建构件,失败整批回滚,回传 revit_id、position(mm,从 LocationPoint 回读)与 level。编译见 revit_addin/README.md。
position 是校核的前提:没有它就查不了错位。
把 config.bridge_url 指向该端点后,run_revit_script 自动切 bridge 模式;未配置时走 local 模拟模式,便于无 Revit 的机器测试识别链路。
配置
{
"workspace_dir": "./workspace",
"allowed_paths": ["./workspace", "/path/to/drawings"],
"confidence_threshold": 0.75,
"review_threshold": 0.9,
"batch_size": 80,
"rule_set_version": "structure-2026.11",
"default_level": "1F",
"bridge_url": "http://127.0.0.1:8787",
"dwg_converter": "",
"family_map": {
"column": {"family": "结构柱-混凝土矩形", "type": "矩形柱"}
},
"level_map": {"1F": 0.0, "2F": 3000.0, "3F": 6000.0}
}dwg_converter 指向可执行文件,签名为 <converter> input.dwg output.dxf;允许带参数(如 ODAFileConverter --recurse),内部按 shlex 切分,不经 shell。
测试
python -m pytest -q
ruff check src tests28 个用例覆盖解析、四类构件识别、构件图(交点锚定/支座/孤立/子图切片/确定性)、批次规划、幂等执行、回验、路径白名单(含兄弟目录前缀绕过)、IR 往返与打包完整性。
路线图
0.1:结构四类构件、DXF、规则识别、本地模拟执行、报告0.2(当前):构件图与拓扑校验、IR 1.1、query_graph、转换链路规格、安全与幂等修复、安装可用性修复0.3:Revit Add-in 实测与族模板校验、DWG 转换链路、圆弧/斜向轴网0.4:OCR 标注、梁跨与竖向传力关系、批量图纸队列之后:建筑与机电专业、模型 diff
贡献
见 CONTRIBUTING.md。提交前请确保 pytest 与 ruff 全绿,并说明规则改动对置信度与图关系的影响;改动了 rules/structure_default.json 时需同步包内副本。
免责声明
本工具输出的是待复核的建模草稿。结构计算结果、构件尺寸、连接关系必须由具备资质的工程师复核,不得直接作为施工依据。作者不对使用本工具造成的任何工程后果承担责任。
License
MIT,见 LICENSE。
Available Tools
8 toolscheck_modelC
模型与原图比对,输出漏识别、错位、参数缺失、重复构件与拓扑异常。
Inputs: task_id (required), checks, tolerance_mm. Returns: result
detect_componentsC
识别轴网、柱、墙、梁,输出带证据与置信度的构件IR、疑点清单与构件关系图。
Inputs: task_id (required), rule_set, element_types, confidence_threshold. Returns: result
export_reportC
导出建模报告,含体检结论、自动完成比例、图关系与拓扑、失败明细与待复核清单。
Inputs: task_id (required), format, template. Returns: result
generate_revit_scriptC
把构件IR转换为确定性建模指令集,完成族类型映射与标高换算。
Inputs: task_id (required), level_map, batch_size, family_map. Returns: result
parse_dwgC
解析DXF/DWG图纸并做可用性体检,返回图层、文字、图框与健康结论。
Inputs: file_path (required), discipline, level_name, convert_dwg. Returns: result
query_graphB
按构件、关系类型和邻域深度查询构件关系图,返回节点、关系、异常与可读摘要。
Inputs: task_id (required), depth, element_id, relation_types. Returns: result
resolve_ambiguitiesB
对低置信度或拓扑异常构件执行采纳、修正或排除,并记录裁决依据。
Inputs: task_id (required), decisions (required), apply_to_similar. Returns: result
run_revit_scriptB
在本地Revit按批次建模;dry_run只校验,失败批次整批回滚。
Inputs: task_id (required), resume, dry_run, autosave_snapshot. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool maps cleanly to a distinct stage of the CAD-to-Revit pipeline: parse, detect, resolve, query, generate, run, check, and report. Although several tools mention anomalies or graph output, their actions and stage-specific purposes are clearly separated.
All tool names use lowercase snake_case with a consistent verb_noun structure, such as parse_dwg, detect_components, generate_revit_script, and check_model. The convention is predictable across the entire set.
Eight tools is well-scoped for an end-to-end CAD-to-Revit workflow, with one tool per major pipeline operation. No tool appears redundant, and the set is not so large that it becomes difficult to navigate.
The surface covers the full lifecycle from DWG parsing through component detection, ambiguity resolution, script generation, execution, validation, and reporting. Minor gaps remain, such as direct component-level inspection/editing outside ambiguity resolution and job-status or abort controls for long-running Revit operations.
Maintenance
Related MCP Connectors
DXF and PDF/X-4 for AI agents: structured facts, PNG renders, an interactive in-chat viewer.
Read, query, edit and render DWG drawings with AI. No AutoCAD required.
Convert Revit files to XKT, IFC, or DWG and query BIM data via natural language.
AI takeoff for construction: turn PDF blueprints into structured, traceable quantities.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceMCP server for Autodesk Revit (BIM) with 705+ API endpoints. Enables AI agents to create walls, place doors/windows, generate sheets, manage views, and produce construction documents via the Model Context Protocol. Uses named pipes for zero-crash Revit integration.22MIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language control of Autodesk Revit through an AI-powered MCP server, allowing creation of walls, rooms, floor plans, and dimensions using conversational commands.-
- FlicenseNot gradedqualityAmaintenanceAI-powered control of Autodesk Revit through the Model Context Protocol, enabling natural language BIM workflows.111-
- AlicenseNot gradedqualityAmaintenanceAn MCP server that bridges AI agents to Autodesk Revit, enabling local tool-based interaction with Revit models, including query, create, and modify operations, with an optional personal tool baking system.136Apache 2.0