Skip to main content
Glama
cad2revit-mcp

cad2revit-mcp

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),否则 E-1002

图纸内文字标注(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)。工作区目录必须先存在;服务不会自行创建白名单之外的路径。

八个工具

工具

作用

关键约束

parse_dwg

解析图纸,输出图层、文字、图框与体检结论

只读;路径必须在白名单内

detect_components

识别轴网/柱/墙/梁,输出 IR、构件图与疑点

每个构件带 evidence 与 confidence

query_graph

按构件/关系类型/邻域深度查构件图

先看图关系,再裁决

resolve_ambiguities

对疑点执行 accept / modify / exclude

只改点名构件,不「改一个动一片」

generate_revit_script

生成确定性指令集,分批并计算哈希

族类型、标高缺失即跳过并告警

run_revit_script

按批执行,失败批次整批回滚

幂等键去重,重复执行不重复建模

check_model

与原图比对,查漏、错位、缺参、重复、拓扑

默认容差 50mm

export_report

导出六段式建模报告

目前仅 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"]}
}

关系

含义

发现的问题

column_at_intersection

柱落在轴网交点

不在交点 → not_on_grid

beam_end_supported

梁端落在柱/墙

两端都无支座 → beam_unsupported

wall_follows_grid

墙沿轴线

自由墙需复核

element_overlap

同类构件重叠

重复识别

wall_intersects_column

墙穿柱

建模错误

拓扑异常不代表工具出错,而是图纸本身有问题,因此只告警(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。

识别是怎么做的

规则而不是「猜」:

  1. 图层语义:图层名正则匹配(KZ/QT/KL/AXIS/轴线 等),命中记 layer_weight。

  2. 几何约束:柱看闭合多段线或图块包围盒;墙看平行线间距(60–400mm)与重叠长度;梁看梁线长度与标注距离;轴网看贯穿长度。

  3. 文字证据:就近取标注,解析 600x600、250x600 这类截面;标注与几何矛盾时扣分并生成疑点。

  4. 置信度: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 tests

28 个用例覆盖解析、四类构件识别、构件图(交点锚定/支座/孤立/子图切片/确定性)、批次规划、幂等执行、回验、路径白名单(含兄弟目录前缀绕过)、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 tools
check_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

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      MCP 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.
      22
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language control of Autodesk Revit through an AI-powered MCP server, allowing creation of walls, rooms, floor plans, and dimensions using conversational commands.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      AI-powered control of Autodesk Revit through the Model Context Protocol, enabling natural language BIM workflows.
      111
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      An 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.
      136
      Apache 2.0