AutoCAD MCP

Construction AutoCAD MCP

English | Tiếng Việt

Construction AutoCAD MCP 让 Claude 可以直接在你于 AutoCAD 中打开的图纸里工作。它的主要工作是制图：根据扫描或拍摄的平面图、草图、效果图或 3D 模型，Claude 会绘制完整的分层 2D 图纸（墙体交接处整齐、带有材料填充图案，门窗嵌入墙体，包含柱子、带圆圈标记的轴网、楼梯、标注面积的房间、尺寸链、符号，以及带标题栏的图纸和 PDF）。它还能根据同一张平面图推导立面图和剖面图，绘制钢筋混凝土详图（梁、柱、基础）及其钢筋明细表，并生成室内设计图纸集：家具布置图、地面饰面图和天花板图、每面墙的室内立面图、木作施工图和饰面明细表。它还可以读取图纸、按图层和块统计工程量，并检查图纸中的常见问题。

它的工作方式类似于 SketchUp MCP：一个 Claude Desktop 扩展（.mcpb），运行于 Claude Desktop 内置的 Node.js 上，外加一个在 AutoCAD 内运行的小型插件（ACAD MCP Bridge，一个 .NET 插件）。无需安装 Python 或 Node.js。

当前版本：1.2.1 - 从 Releases 下载。也已列入官方 MCP Registry，条目为 io.github.2ez4gcx/construction-autocad-mcp。

功能

53 个工具。长度单位为图纸单位（公制图纸中为 mm），面积单位为 m²，角度单位为度，以 +X 方向为基准逆时针计量。

分组	工具
读取与工程量	ping、drawing_info、list_layers、list_blocks、query_entities、selection_info、quantity_takeoff、check_drawing
标准	setup_layers、setup_styles
绘图与编辑	draw_plan、draw_entities、define_block、transform_entities、set_properties、delete_entities、select_entities、undo、purge_drawing
立面图、剖面图与结构	draw_elevation、draw_section、draw_roof_plan、draw_door_schedule、draw_stair_detail、draw_finish_quantities、draw_structure_plan、draw_beam_schedule、draw_structure_notes、draw_structure_detail、rebar_schedule、structural_calc、draw_quantity_schedule
室内设计	draw_furniture_plan、draw_floor_finish_plan、draw_wall_finish_plan、draw_ceiling_plan、draw_interior_elevation、draw_joinery_detail、material_schedule
图像与 3D 来源	view_image、attach_image、import_drawing、screenshot、set_view
图纸与文件	create_layout、draw_cover_sheet、draw_drawing_list、export_pdf、save_drawing、open_drawing、new_drawing
脚本	run_lisp
设置	install_autocad_bridge

亮点：

• 先询问，再作假设：在绘图前，Claude 会列出请求中未明确的内容（无法从图像读取的尺寸、高度、屋顶、材料、家具、结构尺寸等）以及将采用的值，并在你确认或修改后再绘图。draw_plan、draw_elevation、draw_section、draw_structure_detail 和室内绘图工具支持设置 dry_run=true，以列出它们将采用的默认值，但不绘图；每项结果都会报告实际采用的默认值（assumed）。
• 一步完成完整平面图（draw_plan）：Claude 会用毫米描述从图像中读取的平面图（墙轴线和厚度、按墙体和偏移量标注的洞口、柱、轴网、房间、楼梯、标高、剖切符号、指北针），工具则会在一个撤销步骤中绘制全部内容：
  • 墙体会合并绘制，因此 L、T 和 X 形交接处会干净利落，并按材料使用不同的填充图案（砖、混凝土、砌块、轻质材料、石材、实心）；
  • 门（单扇、双扇、推拉门）、窗和普通洞口会从墙体中切出，并绘制门扇、开启弧线和玻璃线；
  • 柱会从墙体中切出并填充；每个轴网交点都可以放置一根柱；
  • 轴网两端都会添加圆圈编号（横向为 1、2、3……，纵向为 A、B、C……）；会在你选择的侧边添加外部尺寸链（洞口、轴网间距、总尺寸）；
  • 房间面积根据墙体测量，绝不手动输入：每个房间取其中一点；标注显示房间名称和测量面积（若名称比房间宽，则换为两行，并将标注避开墙体）；封闭边界绘制在 A-AREA（不打印）图层上，用于工程量统计；还会报告由墙体围合但未标注房间的空间。
• 从平面图生成立面和剖面（draw_elevation、draw_section）：基于与 draw_plan 相同的描述生成，因此两者始终一致。各处高度（楼面、地面、墙顶、门顶、窗台和窗顶、基础）以及屋顶（双坡屋顶，可指定任一屋脊方向、坡度、挑檐，或带女儿墙的平屋顶；可设置多个屋顶，例如门廊屋顶）只需输入一次。
  • 任意方向的立面：以最近的墙和柱为准，移除隐藏线；屋顶显示檐口侧（瓦楞线）或山墙端；绘制带框门窗、勒脚和地面线、标高符号、高度尺寸链、带间距的轴网圆圈、标题；
  • 沿平面图中的剖切符号（或任意剖切线）生成剖面：绘制楼板、屋顶板、过梁，以及每面被剖墙体下方的梁，并填充实心剖切图案（beam_depth 默认为 300）；剖切墙体填充图案，并在穿过的洞口上方绘制过梁；每个房间的天花板按其完成面标高绘制，并显示其降板带和吊杆（连接至楼板）、天花板和地面编码；在两侧绘制标高符号，并用引出线连接至建筑；绘制带素混凝土垫层的基础、地面板和填土、延伸至门廊柱的门廊板、屋顶剖切处、后方可见的墙、门窗、房间名称、标高和轴网；
  • 照片中可见的装饰元素（山墙窗、饰面、尖饰）通过 draw_entities 添加到 A-ELEV 图层。
• 三套图纸，三个文件：建筑（KT）、结构（KC）和室内（NT）图纸分别存放，符合设计办公室的出图方式。每套图纸都通过 new_drawing 根据同一份平面图描述创建，并有各自的图纸目录（draw_drawing_list，图纸 KT-00 / KC-00 / NT-00）、图号和标题栏项目（KIẾN TRÚC、KẾT CẤU、NỘI THẤT）。结构和室内工具可在没有建筑平面图的文件中使用：AutoCAD 会根据平面图描述计算房间轮廓，但不绘制平面图（draw_plan rooms_only）。示例：examples/Nha-pho-5x18-KT.pdf、-KC.pdf、-NT.pdf。
• 屋顶平面图（draw_roof_plan），适用于平屋顶：
  • 顶层女儿墙和楼梯间，带轴网和尺寸；
  • 楼梯间屋顶填充图案，屋顶露台；
  • 地漏及排水坡度（i=2%）和雨水管；
  • 露台、女儿墙顶和楼梯间屋顶标高；
  • 防水、找坡砂浆和管道说明。
• 封面（draw_cover_sheet）：“HỒ SƠ BẢN VẼ ”、阶段、项目、项目内容、客户、顾问、承包商、地点、日期；每套图纸都以封面和图纸目录开篇。
• 门窗表（draw_door_schedule）：
  • 按标签、类型和尺寸列出每种类型（每层均列出），并绘制立面图，显示门窗框、门扇、开启方向（虚线在铰链侧相接）和玻璃；
  • 标注宽度、高度、窗台尺寸、标签和数量；
  • 表格内容：标签、类型、W x H、窗台、各层数量、说明。
• 楼梯详图（draw_stair_detail），适用于 U 形楼梯：
  • 按楼层类型绘制各层楼梯平面图（起步层、合并绘制的标准层、到达层），比例为 1:50，并显示周围墙体、踏步编号、梯段 / 平台 / 宽度尺寸（n x 踏步宽）、楼层和平台标高、轴网和剖切符号；
  • 沿梯段绘制 1-1 剖面：剖切梯段及其钢筋混凝土梯板和平台、后方梯段、剖切的楼板和墙体、带栏杆竖杆的扶手、各梯段的踢面尺寸（n x 踢面高）、层高和标高；
  • 踏步和平台的构造说明，包含 2h + b；
  • 1:20 踏步和扶手详图（花岗岩、砂浆、砖砌踏步、梯板、抹灰、扶手、栏杆竖杆），单独绘制：通过 create_layout views 将两者放在同一张图纸上。
• 初步结构计算（structural_calc），须由持证结构工程师复核、重新计算并签字：
  • 按 TCVN 2737:2023 计算荷载：楼板构造、按房间类型取值的活荷载（房间 1.5、走廊和楼梯 3、阳台 2 kPa……）、隔墙、梁上的墙体（扣除洞口）、自重；
  • 将楼板分担的荷载传递给梁（双向梯形 / 三角形、单向）；对连续梁按所有 / 奇数 / 偶数跨施加活荷载，端部支座取 qL²/24；
  • 按 TCVN 5574:2018 计算弯矩和剪力（αm、ξ ≤ ξR、As、钢筋；支座和跨中箍筋）；设计钢筋会传递给 draw_beam_schedule；
  • 按楼层逐层计算柱荷载，直至基础（支承在楼板上的柱将荷载传给其下方的梁）、柱承载力、满足地基压力要求的基础面积；
  • 包含表格的图纸（材料、楼板荷载、构造、梁、柱和基础、假设）及签字栏：计算、复核、结构负责人（姓名、执业证号、签名、日期）；提供 CSV，供 Excel 使用；
  • xlsx_path：可实时更新的 Excel 工作簿：输入项位于黄色单元格中（材料、各层厚度和容重、荷载系数、活荷载、地基承载力、柱和基础尺寸、q、钢筋），其余内容均为公式（g、p、M、αm、ξ、As、验算、箍筋间距、柱承载力、基础面积）；数值变更后会自动重新计算。
• 钢筋表和工程量清单（draw_quantity_schedule）：
  • 整套图纸的钢筋表：基础、柱、地梁和梁按设计取值，楼板和楼梯按详图规则计算；包含搭接和锚固、作为表格公式的重量、按直径汇总的总量，并可跨页续表；
  • 工程量清单，列明各项目的构成：素混凝土垫层、基础混凝土和模板、柱墩、地梁、各层柱、梁、楼板、楼梯；按等级统计钢筋；按厚度统计砖墙（m²、m³），并扣除洞口；室内、室外和板底抹灰；提供 CSV，供 Excel 使用；
  • xlsx_path：完整的结构工作簿（计算、重量为公式的钢筋表，以及按构成公式计算的工程量）。
• 建筑装修工程量（draw_finish_quantities）：按饰面类型统计地砖、墙砖和踢脚线；内墙、外墙（无房间相邻侧、勒脚、女儿墙）及天花板的批嵌和涂料；石膏板吊顶；卫生间、阳台和屋顶露台防水；找坡砂浆和楼梯间屋顶；楼梯花岗岩和栏杆、阳台栏杆；按类型统计门窗。房间和饰面均取自室内图纸。提供按楼层统计各项工程量的表格、CSV 和 Excel 工作簿，其中各楼层各占一列，总量为各层之和。
• 结构图纸（draw_structure_plan、draw_beam_schedule、draw_structure_notes）：
  • draw_structure_plan floor=foundation 绘制基础平面图：柱下独立基础 M1（隐藏显示）、首层墙体下方的地梁 GM、基础尺寸和底标高；
  • draw_structure_plan 绘制各层楼板（第 2 层、第 3 层……以及屋顶）的梁板布置图：
    • 沿下层承重墙布置梁（厚度小于 150 mm 的隔墙支承在楼板上），按楼板编号（D2.1……，屋顶为 DM.1），标注 b x h 和数量；
    • 在墙体交点处布置柱；
    • 标注楼板厚度；下沉 50 的湿区和阳台以填充图案显示；楼梯洞口用交叉线标示；
    • 绘制带圆圈编号和尺寸的轴网。 尺寸为初步估算值（h = 跨度/12，向上取整至 50，范围 300-700），并标注为假定值，需由工程师确认。
  • draw_beam_schedule 为每种梁提供支座（GỐI）和跨中（NHỊP）截面，包括板翼缘、FL 标高、钢筋和箍筋，标题为“DẦM D2.1 (200x400) - SL: 02”。
  • draw_structure_notes 将通用说明绘制成表格：
    • 材料（B20 / B15 / B7.5、CB240-T / CB300-V）；
    • 按构件列出的混凝土保护层；
    • 按直径列出的锚固长度和搭接长度；
    • 按跨度列出的典型过梁；
    • 编号说明（默认采用 TCVN 5574:2018，所有数值均可提供）。
• 结构详图（draw_structure_detail、rebar_schedule）：带钢筋和 135° 箍筋弯钩的横截面；多跨梁（底筋和顶筋、跨长一定比例范围内的支座钢筋、加密和常规箍筋区、1-1 和 2-2 截面）；带网片的独立基础、柱插筋、箍筋和标高；带引线的钢筋标记，每根不同的钢筋都有自己的标记。每个详图都会返回钢筋表行；rebar_schedule 会将它们合并为钢筋表（钢筋、总长度、每行按 d²/162 kg/m 计算的重量、按直径及总计），并以表格和 CSV 格式输出。尺寸和钢筋由工程师提供：工具负责绘图，不负责设计；如果钢筋间距不满足净距要求，则会发出警告。
• 室内设计（基于 draw_plan 的平面图；材料代码与 SketchUp MCP 相同：FL 地面、SK 踢脚线、WL 墙面、CL 天花板、JN 木作、FN 家具、SN 卫生洁具、EQ 设备、LT 照明，每项规格使用一个代码）：
  • draw_furniture_plan：以 1:50 比例复制平面图，并使用家具库（床、床头柜、衣柜、沙发、桌椅、书桌、电视柜、厨房地柜和吊柜及水槽和灶具、油烟机、冰箱、洗衣机、马桶、洗手台、淋浴间、浴缸、鞋柜、书架）；按偏移量将家具靠墙放置，避免代码标记相互重叠，将房间名称移至家具和门扇开启范围之外，并标注立面索引 A-D；
  • draw_floor_finish_plan：绘制各房间实际的瓷砖或地板拼缝（居中铺砖或从起铺点开始铺设、错缝铺板），并避开房间名称和代码标记；附带标注各饰面的面积的图例；
  • draw_floor_finish_plan 还会标注施工现场所需的细节：
    • 每扇门下方设置不锈钢收口条，以处理饰面或标高变化；
    • 湿区和室外设置地漏（有淋浴间时设在淋浴间内）、坡向箭头“i=1%”和降板高度（湿区 20 mm，室外 50 mm）；
    • 标明瓷砖的铺设方式（LÁT TỪ TÂM）；
  • draw_wall_finish_plan：沿每面墙的内侧绘制饰面纹理带（涂料用一条线表示，瓷砖用两条线并标出拼缝），在门窗处断开；绘制橱柜地柜后方的厨房防溅墙；每个房间标注饰面代码和贴砖高度；图例列出各墙面饰面的面积；
  • draw_ceiling_plan：沿墙绘制跌级带，并标出跌级线和 LED 灯槽；在灯带内布置筒灯（或按网格布置）；每张餐桌上方布置吸顶灯或吊灯；标注标高（代码上方标标高），并附带列出灯具数量的照明图例。mode=finish 输出天花饰面图（材料、标高、标注尺寸的跌级宽度、列出面积的天花图例；不含灯具），mode=lighting 输出照明布置图（灯具及其图例；不含标高标记）；
  • 每张室内图纸最后都会附上通用说明（GHI CHÚ：单位、现场核验、材料审批，以及各图纸对应的内容：瓷砖拼缝和坡度、涂料和贴砖构造层、板材和检修口、灯具定位），也可以使用你提供的说明；
  • draw_interior_elevation：从室内视角绘制房间的每面墙：剖切墙体、地面和天花板（含跌级带），墙上的门窗，以及靠墙家具和木作（正视图）和墙角处家具和木作（侧视图），均以块表示（每种类型、尺寸和视图各一个块，NT_MD_... / NT_MB_...）；轮廓下方设有遮罩，以便近处物件遮挡其后的内容；标出墙砖拼缝、厨房防溅墙、踢脚线、尺寸链，以及带引线的材料说明；
  • draw_joinery_detail：绘制厨房柜体组合（带柜门/抽屉/水槽模块的地柜、吊柜组合和油烟机、防溅墙）或衣柜：1:10 正视图，标出模块、铰链侧和把手；1-1 剖面穿过柜体，标出板材厚度和材料说明；直接取自布置平面图中的柜体；
  • material_schedule：地面和天花板以 m² 计，踢脚线以 m 计（扣除门洞），墙面以 m² 计（扣除洞口和防溅墙），家具、木作、卫生洁具、设备和灯具按数量计；每个代码一行，并列出对应房间；提供表格和 CSV。 各类房间默认采用不同饰面（干区采用 600x600 瓷质砖、涂料和带跌级带的石膏板天花板；卫生间采用防滑砖、墙砖贴至天花板和防潮天花板；庭院不设天花板），每项结果都会列出所采用的假设。
• 多层建筑（draw_plan 配合 floors）：每层都有自己的墙体（也可以沿用下层墙体）、洞口、楼梯、阳台、房间和屋顶；层高默认分别为首层 3600、其余楼层 3300，楼板厚度 120；女儿墙按下方墙体复制，并采用其自身高度；U 形楼梯在首层标注 UP，中间层标注 UP/DOWN，顶层标注 DOWN；阳台设有板边和栏杆。各层平面图并排绘制，立面图和剖面图按楼层叠加绘制（标出各层和女儿墙标高、阳台栏杆、楼板中的楼梯间洞口，以及沿楼梯梯段剖切的楼梯），室内工具支持传入 floor。
• 使用块、字段和多重引线，而非单纯的线条：
  • 门、窗和推拉门均为块，每种尺寸各一个（MCP_CUA_DI_900、MCP_CUA_DI_2C_1400、MCP_CUA_SO_1200_220），以旋转或镜像方式插入，并带有代码、类型和宽度属性；
  • 家具和卫生洁具按类别及尺寸分别使用一个块（NT_<code>_<type>_<width>x<depth>），属性包括代码、名称和尺寸；
  • 灯具（MCP_DEN_*）、代码标记、天花板标记、轴网气泡、标高标记、剖面标记、指北针、室内立面索引、钢筋标记和标题栏也都使用块，数值存为属性。quantity_takeoff group_by=block 会按块及其属性统计数量；可通过 ATTEDIT 或特性选项板编辑这些属性。 定义会在首次使用时创建。AutoCAD API 无法创建动态块，因此每种尺寸都有各自的定义。 房间标签将面积显示为房间 A-AREA 边界的字段：拉伸边界，然后执行 REGEN 或 UPDATEFIELD。 室内立面图的材料注释使用多重引线，其内容为标记块（代码置于方框中，下方为简短说明），排列在立面图上方（地面和踢脚线标记排列在下方），采用虚线，并按照所标注对象的顺序排列，确保线条不会交叉。木作细部保留一列文字多重引线。 家具和门的标记为六边形，材料标记为矩形。每张图纸均以带下划线的名称和“比例：1/50”作为标题。 材料明细表在每个项目和灯具的代码旁显示其块。
• 专业图层（setup_layers）：符合 AIA/NCS 风格的建筑图层集，包含适用于单色打印的线宽，以及越南语或英语说明：S-GRID（CENTER）、S-COLS、A-WALL（0.5 mm）、A-WALL-PATT、A-DOOR、A-GLAZ、A-OPEN、A-FLOR-STRS、A-FURN、A-FLOR-FIXT、A-AREA（不打印）、A-ANNO-ROOM、A-ANNO-TEXT、A-ANNO-DIMS、A-ANNO-SYMB、A-ANNO-TTLB、A-ANNO-NOTE、A-ELEV、A-SECT、A-FLOR-CASE、A-CLNG、E-LITE、A-DETL、S-CONC、S-REBR、S-REBR-STIR、X-IMAGE（不打印）……如果图纸已有图层方案，则沿用该方案（draw_plan 接受角色到图层的映射）。
• 绘图比例样式（setup_styles）：单位为 mm，使用 TrueType 文字样式（MCP-ARIAL，确保越南语不会显示为 ?）、采用建筑刻度且文字置于尺寸线上方的标注样式 MCP-1-<scale>、多重引线样式、表格文字和 LTSCALE。
• 使用图像：view_image 将带裁剪的图像文件显示给 Claude（放大细节以读取尺寸），并提供带坐标的像素网格；attach_image 将图像作为淡化底图放置在图纸的 X-IMAGE 图层上，根据已知尺寸的两个像素进行校准，并锚定到图纸上的一个点；draw_entities 可接受图像像素中的点（image_handle）来进行描摹；screenshot 在屏幕外渲染图纸（白色背景，不会影响当前视图），以便 Claude 将绘制结果与源图进行比较。
• 使用 3D 模型：从模型中读取尺寸（例如使用 SketchUp MCP），再用 draw_plan 重绘；或者通过 import_drawing 导入 2D DWG/DXF 导出文件（平面图、剖面图、立面图），并为其图层添加前缀，然后进行清理和标注。
• 所有实体类型（draw_entities）：直线、带圆弧的多段线、矩形、圆、圆弧、椭圆、样条曲线、点、文字和多行文字、图案填充（含岛屿）、线性／对齐／角度／半径／直径标注、带总尺寸的尺寸链、多重引线、带属性的块（也可来自 DWG 文件）、表格。每个批次为一个撤销步骤；如果有实体错误，则不会绘制任何内容，并会指出出错的实体。
• 按句柄编辑：移动、复制（重复）、旋转、缩放、镜像、矩形阵列和环形阵列、偏移（朝向某点或向两侧）、分解（保留块属性值）；还可编辑特性、文字和属性值。
• 工程量（quantity_takeoff）：按图层、块或类型统计数量、长度（m）、闭合轮廓面积（m²）、填充面积（m²），以及块数量和属性值统计；支持导出为 Excel 使用的 CSV（对于越南语／欧洲区域设置下的 Excel，使用 csv_format=semicolon：以 ; 分隔，使用逗号作为小数点）。
• 图纸 QA（check_drawing）：检查重叠重复对象（会导致工程量重复）、看似闭合但实际未闭合的多段线、面积图层上的开放轮廓、SHX 样式中的越南语文字（会显示为 ?）、缺失字体、未解析的外部参照和图像、Defpoints 上的对象、被手动覆盖的标注值、远离其他对象的对象、位于图层 0 上的对象、未设置为 ByLayer 的颜色／线型／线宽，以及不符合命名标准的图层。
• 字段：
  • 房间面积是房间边界的字段；
  • 装修明细表中的地面和天花板工程量是汇总房间边界的公式字段；
  • 钢筋明细表的合计（每行、每种直径及总计的根数、长度、重量）使用表格公式：更改表格中的根数或长度，重量便会随之更新；
  • 标题栏的比例是视口比例的字段，图号是布局名称的字段。 越南语中的小数逗号。
• 图纸（create_layout、export_pdf）：采用 DWG To PDF.pc3 和 monochrome.ctb 的 ISO A0-A4 图纸布局，包含符合 ISO/TCVN 边距标准的边框、标题栏和锁定的视口。
  • 横向 A3-A0 图纸的标题栏是越南建筑图纸集常用的纵向条带，包含修订记录、备注、客户、项目、项次、顾问、项目负责人、部门负责人、设计者、校对者、图纸名称、合同、版本、阶段、图号、比例和日期，底部另有一条通用备注。title_block.style=bottom 会生成 180 mm 的底部标题栏，A4 和纵向图纸会使用这种样式。两种样式都是带属性的图块。
  • views 会在一张图纸上放置多个视口，每个视口都是具有独立比例的模型窗口（例如，一个比例为 1:100 的平面图搭配一个比例为 1:25 的详图，或将三个楼层平面图并排放置）：视口按行排列，底部对齐，并在绘图区域内居中；比例不同时，标题栏中的比例会显示为“NHƯ HÌNH”。
  • 视口会自动适配到标准比例，放置在标题栏上方或旁边，以能容纳视图的位置为准（若指定比例会导致视图被裁切，则会发出警告）。export_pdf 会将图纸布局打印为一个多页 PDF（不同纸张尺寸的布局会分别生成 PDF，例如 set_A3.pdf、set_A1.pdf），也可以按指定比例打印模型空间窗口。
• 文件（save_drawing、screenshot save_path）：支持 DWG 2018/2013/2010/2007/2004/2000 和 DXF；copy=true（旧版本和 DXF 的默认值）会写入导出副本，并保留当前打开的图纸不变，否则会执行“另存为”；支持将图纸保存为最长边不超过 4096 px 的 PNG 图像。
• run_lisp：没有合适的工具时，Claude 会将 AutoLISP 作为一个撤消组运行（结果以 JSON 返回）。代码不会访问磁盘，因此 AutoCAD 的 SECURELOAD 不会对此发出询问。
• 每次图纸编辑都是一个撤消步骤（在 AutoCAD 的撤消列表中显示为 MCP_<TOOL>）。
• AutoCAD 命令：MCPSTATUS、MCPSTART、MCPSTOP、MCPPORT、MCPLOG。

工作原理

Claude Desktop
    |  MCP over stdio
    v
construction-autocad-mcp-1.2.1.mcpb        Node.js MCP server, runs on the Node built into Claude Desktop
    |  one JSON request per command, TCP 127.0.0.1:9877 (localhost only)
    v
ACAD MCP Bridge               .NET add-in inside AutoCAD (autoloader bundle), runs commands on AutoCAD's main thread
    |  AutoCAD .NET API
    v
the open drawing

桥接程序在 AutoCAD 内部运行（而非通过外部 COM 运行）：每条命令都在一个文档锁定中，由 AutoCAD 主线程执行；处理大型图纸时速度快、安全，并且每条命令对应一个撤消步骤。

要求

• Claude Desktop（当前版本，包含 设置 > 扩展）。
• AutoCAD 2021、2022、2023 或 2024（完整版 AutoCAD 或垂直行业版本，例如 AutoCAD Architecture；不支持 AutoCAD LT，因为它无法加载 .NET 加载项），运行于 Windows 10/11。已在 AutoCAD 2024 上测试。AutoCAD 2025 及更高版本运行于 .NET 8，需要使用为其构建的桥接程序（目前尚未提供）。
• 仅从源代码构建时：Node.js 18+、Visual Studio Build Tools C# 编译器，以及已安装的 AutoCAD 2021-2024。

安装

1. 在 Claude Desktop 中安装扩展：从最新版本下载 construction-autocad-mcp-1.2.1.mcpb 和 AcadMcpBridge-1.2.1.bundle.zip，然后在 Settings > Extensions 中将 .mcpb 拖放到窗口里（或选择 Advanced settings > Install Extension...），再点击 Install。此构建未经代码签名，因此 Claude Desktop 可能会发出警告。
2. 在 AutoCAD 中安装桥接程序：在新对话中让 Claude 执行 "Install the ACAD MCP Bridge in AutoCAD"（工具 install_autocad_bridge）。它会将 AcadMcpBridge.bundle 复制到 %APPDATA%\Autodesk\ApplicationPlugins，AutoCAD 会在启动时加载该文件夹中的内容。手动安装：将 AcadMcpBridge-1.2.1.bundle.zip 解压到该文件夹。
3. **重启 AutoCAD。**该加载项未经数字签名：当 AutoCAD 询问是否加载 AcadMcpBridge-1.2.0.dll 时，选择 Always Load。每个新版本的桥接程序构建都会生成一个新文件，因此更新后 AutoCAD 会再次询问。（若要避免此提示，可以将捆绑包文件夹添加到 Options > Files > Trusted Locations，前提是 IT 策略允许。）在 AutoCAD 中输入 MCPSTATUS：应该会显示 ACAD MCP Bridge v1.2.0: RUNNING on 127.0.0.1:9877。然后让 Claude 执行 "Ping AutoCAD"。

在 Settings > Extensions > Construction AutoCAD MCP > Configure 中可设置选项：桥接程序端口（默认值为 9877；如果更改，也要在 AutoCAD 中输入 MCPPORT）以及每条命令的超时时间（默认值为 120 s）。

更新方法：安装新版 .mcpb，再次让 Claude 安装桥接程序，然后重启 AutoCAD。

典型会话：根据图像绘制平面图

这是首层平面图的扫描件（D:/Project/scan.jpg）。请在 AutoCAD 中按 1:100 的比例绘制，使用标准图层，标注完整尺寸和房间面积，然后制作一张 A3 图纸并导出为 PDF。

接下来，Claude 会查看图像（使用 view_image，放大查看尺寸），设置图层和样式，将扫描件作为经过校准的底图附加，使用 draw_plan 绘制平面图，使用 draw_entities 添加家具、设备和注释，通过 screenshot 对比并修正差异，运行 check_drawing，最后创建布局并生成 PDF。

一套联排住宅的 3 套图纸，房屋尺寸为 5x18 m，共 3 层并带楼梯间，每套各自成图，供事务所发布：

• 建筑 examples/Nha-pho-5x18-KT.pdf：图纸目录、平面图、立面图、剖面图；
• 结构 examples/Nha-pho-5x18-KC.pdf：图纸目录、总说明、2 楼和 3 楼楼板、楼梯间及屋面的结构平面图、梁表；
• 室内 examples/Nha-pho-5x18-NT.pdf：图纸目录、家具、地面、墙面和天花板饰面图、照明图、室内立面图、饰面表。

对应的 DWG 文件与这些文件放在一起。

根据一张照片制作的完整图纸集（未包含照片本身）：examples/Nha-6x15-ho-so.pdf（6 张 A3 图纸：平面图、4 个立面图、1:100 的 A-A 和 B-B 剖面图、1:25 的梁、柱、基础和钢筋表）；室内图纸集 examples/Nha-6x15-noi-that.pdf（10 张图纸：1:50 的家具布置图、地面饰面图和天花板图；1:30 的卧室、厨房和 WC 室内立面图；1:10 的厨房和衣柜施工图；饰面表；CSV examples/Nha-6x15-vat-lieu.csv）；所有图纸均在 examples/Nha-6x15-ho-so.dwg 中。

更多提示词：mcpb/release-docs/SAMPLE_PROMPTS.md。

其他 MCP 客户端

该服务是通过 stdio 通信的标准 MCP 服务。解压 .mcpb（它是一个 zip 文件），并注册 node <folder>/server/index.mjs，例如在 Claude Code 中：

claude mcp add autocad --scope user -e AUTOCAD_MCP_TIMEOUT=120 -- node C:/Tools/construction-autocad-mcp/server/index.mjs

环境变量：AUTOCAD_MCP_PORT（默认值为 9877）、AUTOCAD_MCP_TIMEOUT（单位为秒，默认值为 120）。

故障排除

问题	解决方法
Cannot connect to AutoCAD	在 AutoCAD 中输入 MCPSTATUS。如果提示命令未知：安装桥接程序并重启 AutoCAD（并允许加载 DLL）。如果状态为 STOPPED：运行 MCPSTART。如果端口 9877 被其他程序占用：运行 MCPPORT。
AutoCAD 询问是否加载 AcadMcpBridge-...dll，但桥接程序没有启动	你选择了 Do Not Load：AutoCAD 会在本次会话中记住此选择。重启 AutoCAD，并选择 Always Load。
每次导出 PDF 都需要约 30 秒	如果默认 Windows 打印机是无法响应的网络打印机，AutoCAD 本身的绘图速度就会很慢（AutoCAD 自带的 PLOT 命令同样慢）。请设置本地默认打印机（例如 Microsoft Print to PDF），或在 AutoCAD 中隐藏系统打印机（Options > Plot and Publish）。
install_autocad_bridge 报错	其他 AutoCAD 可能占用了这些文件：关闭所有 AutoCAD 后再次运行。

安全性

桥接程序仅监听 127.0.0.1，且不进行身份验证，与其他本地 MCP 桥接程序一样：在你的计算机上以你的账户运行的任何程序都可以向它发送命令，包括 run_lisp。不需要时，请在 AutoCAD 中运行 MCPSTOP 停止它。

从源代码构建

cd mcpb
npm ci
npm run build    :: compiles the bridge, bundles the server, packs dist/construction-autocad-mcp-<version>.mcpb
npm test         :: plan engine unit tests + server smoke test

ACAD_DIR 用于指定其他 AutoCAD 2021-2024 文件夹进行构建，CSC 用于指定其他 C# 编译器。

许可证

MIT，详见 LICENSE。