中望CAD（ZWCAD）自动化 MCP 服务，让大模型通过 MCP 协议直接操控 ZWCAD 平台与中望机械CAD，完成绘图、标注、图层/块/样式管理，以及图框、标题栏、明细表（BOM）等机械操作。
分类 | 工具数 | 说明 |
绘图 | 3 |
|
注释与标注 | 3 |
|
实体操作 | 4 |
|
对象查询 | 3 |
|
样式管理 | 1 |
|
视图与布局 | 2 |
|
文档管理 | 1 |
|
表格操作 | 1 |
|
选择集 | 1 |
|
图块管理 | 1 |
|
系统工具 | 3 |
|
诊断工具 | 3 |
|
标题栏 | 1 |
|
图框 | 2 |
|
明细表 | 2 |
|
机械数据库 | 1 |
|
机械应用 | 4 |
|
扩展数据 | 3 |
|
共计 39 个工具，按对机械环境的依赖划分为三组：
分组 | 数量 | 说明 |
ZWCAD 平台工具 | 26 | 不依赖中望机械，只要 ZWCAD 在运行即可使用 |
机械扩展工具 | 11 | 上表中的标题栏(1)、图框(2)、明细表(2)、机械数据库(1)、机械应用(4)，以及 |
统一诊断工具 | 2 |
|
机械工具在未连接中望机械或类型库未加载时返回明确错误（详见「类型库依赖矩阵」）。
Related MCP server: CAD MCP Server
操作系统：Windows 10/11 x64
Python：3.10+；使用 uvx 免安装方式则无需手动准备 Python（会自动拉取）
机械工具：需要中望机械CAD 及其匹配版本的 ZwmToolKit
位数：Python 与 CAD 位数建议一致
确保中望CAD（或中望机械CAD）已启动并打开了一张 DWG 文件。机械工具还需中望机械CAD 及匹配版本的 ZwmToolKit。
可选步骤，仅在需要固定版本或离线部署时执行。
使用本服务无需先安装本包：MCP 客户端通过 uvx zwcad-mcp 启动服务，uvx 会在启动时自动准备 Python 环境、创建隔离环境并拉取全部依赖（等价于 npm 世界的 npx）。前置条件：本机装有 uv。
仅当需要固定版本或离线部署时，才将本包安装到本机 Python：
pip install zwcad-mcp验证安装：
python -c "import importlib.metadata as m; print(m.version('zwcad-mcp'))"本项目是标准 MCP 服务（stdio），任意支持 MCP 协议的客户端均可接入。各客户端使用同一份配置，只是配置文件位置不同：
{
"mcpServers": {
"zwcad": {
"command": "uvx",
"args": ["zwcad-mcp"],
"env": {
"PYTHONUTF8": "1",
"UV_DEFAULT_INDEX": "https://pypi.tuna.tsinghua.edu.cn/simple"
}
}
}
}上面的配置采用免安装方式（由 uvx 启动）：UV_DEFAULT_INDEX 指定国内镜像以加速依赖下载，网络可直连 PyPI 官方源时可删除该行。若已按步骤 2 执行了 pip 安装，可将 command 改为 "zwcad-mcp" 并删除 args 一行。
写入项目内 .cursor/mcp.json 或全局 ~/.cursor/mcp.json，重启 Cursor 后生效。
写入 %APPDATA%\Claude\claude_desktop_config.json，重启 Claude Desktop 后生效。
写入 WorkBuddy 的 MCP 配置文件，重启后生效。
任意支持 MCP stdio 的客户端均可接入：命令为 uvx zwcad-mcp（已执行 pip 安装时可用 zwcad-mcp），并建议设置环境变量 PYTHONUTF8=1。
在客户端中让 AI 调用 zwcad_get_capabilities：能返回 ZWCAD 版本与工具组清单即表示接入成功。若失败，调用 zwcad_diagnose（机械问题用 zwcad_mech_diagnose）查看逐项探测结果与修复建议。
本服务为 stdio 模式，正常使用时由 MCP 客户端自动拉起，无需手动启动。如需排查启动阶段的问题，可在命令行执行
zwcad-mcp（等价的本地方式：python src/server.py）。
工具 | 说明 | entity_type / solid_type |
| 绘制2D实体 |
|
| 批量绘制多个实体，减少交互轮次 |
|
| 绘制3D实体 |
|
工具 | 说明 | annotation_type / dim_type |
| 添加注释对象 |
|
| 添加标注（支持公差/配合代号） |
|
| 在指定位置插入图块 |
|
标注公差与配合（zwcad_add_dimension 与 zwcad_modify_entity(entity_type="dimension") 通用，均放在 params 中，可选）：
参数 | 说明 |
| 公差显示方式： |
| 上/下偏差（带符号，如 |
| 公差小数位数 0-8 |
| 公差字高系数（GB 常用 0.7） |
| 配合代号，如 |
| 配合代号是否堆叠（默认 |
| 标注文字前缀/后缀/替代（ |
示例：直径50H7孔 → zwcad_add_dimension(dim_type="diametric", params={..., "fit_symbol": "H7"})；
50(+0.021/0)偏差 → params={..., "tolerance_display": "deviation", "upper_deviation": 0.021, "lower_deviation": 0}；
已有标注补公差 → zwcad_modify_entity(entity_type="dimension", handle="A3F", params={"tolerance_display": "limits", ...})。
工具 | 说明 | action / entity_type |
| 实体变换 |
|
| 修改实体几何属性（含标注公差/配合） |
|
| 获取实体详细信息（属性、几何数据、边界框） | - |
| 设置实体通用属性（图层/颜色/线型等） | - |
实体定位方式统一：
handle（优先，O(1)）或object_type+property_name+property_value。
工具 | 说明 |
| 按类型/属性/句柄查找对象 |
| 获取模型空间对象列表（ |
| 快速查询所有标注（尺寸值/公差/文字覆盖等）；原生 DXF 过滤，远快于逐个迭代； |
工具 | 说明 | style_type × action |
| 图层/线型/文字/标注样式 CRUD | style_type: |
工具 | 说明 | action / mode |
| 布局/视图管理 |
|
| 视图缩放 |
|
工具 | 说明 | action |
| 文档新建/保存/关闭/导入/导出/打印 |
|
工具 | 说明 |
| 表格单元格/行/列操作（ |
| 选择集操作（窗口/交叉/多边形/过滤器选择） |
| 图块定义/信息/属性管理（ |
工具 | 说明 |
| 读写系统变量（如 |
| 获取应用信息。scope: |
工具 | 说明 |
| 查看当前可用的产品、连接状态、工具组和活动图纸 |
| 诊断平台和机械后端，并给出不修改系统的排障建议 |
| 诊断机械模块连接与 ZwmToolKit 类型库加载状态。逐项探测：类型库加载、ZWCAD 应用、ZwmApp、ZwmDb、标题栏获取，返回各探测项状态与修复建议。每次调用自动重置连接缓存以获取最新状态 |
工具 | 说明 | action |
| 标题栏读取/设置/批量更新 |
|
⚠️ 此工具依赖 ZwmToolKit 类型库，类型库未加载时将快速返回
TYPELIB_NOT_LOADED错误。
工具 | 说明 | action |
| 图框查询/切换/更新/刷新 |
|
| 新建图幅/图框（所有参数可选，默认从 XML 配置读取） |
|
⚠️
zwcad_mech_create_frame以及zwcad_mech_manage_frame的get_info/update操作依赖类型库；list/get_count/switch/refresh等操作不依赖类型库，在类型库未加载时仍可使用。
工具 | 说明 | action |
| 明细表增删改查 |
|
| 创建明细表实体 | 发送 |
⚠️ 除
refresh外的所有操作依赖类型库。refresh不依赖类型库，在类型库未加载时仍可使用。💡 BOM 持久化说明：修改 BOM 数据后，
update_row/set_field/batch_update等操作会自动将更改写入 DWG 图纸。请勿在 BOM 修改后调用zwcad_mech_manage_db的save操作，save会从图纸重载数据导致修改丢失。
工具 | 说明 |
| 机械数据库操作。action: |
| 机械文档操作。action: |
| 初始化 CAD 标准环境（GB, ISO, DIN 等） |
| 获取球标对象用于零件编号标注 |
| 插入球标（零件序号标注），通过 LISP 命令 |
以上工具不依赖类型库，在类型库未加载时仍可通过 late binding 正常工作。
工具 | 说明 | action |
| 命名对象字典与 XRecord 管理 |
|
| 实体扩展数据(XData)读写 |
|
| CAD 工具方法（坐标转换/角度/距离计算） |
|
机械模块（标题栏/明细表/图框等）依赖 ZwmToolKit.tlb 类型库。pyzwcadmech.api 采用 5 级回退策略 加载类型库，确保在各种安装环境下都能成功加载：
优先级 | 策略 | 说明 |
1 | 文件系统 glob | 在 |
2 | 环境变量 | 读取 |
3 | 本地路径 | 搜索当前工作目录和包目录下的 |
4 | 预生成模块 | 复用已生成的 |
5 | GUID 注册表 | 按类型库 GUID |
src/server.py（MCP Server 主程序，入口见「快速开始」第 3 步）在导入时按上述 GUID 调用 comtypes.client.GetModule 预加载类型库。预加载成功时，后续 pyzwcadmech.api 即使文件搜索失败，也能通过策略 4 复用已生成的模块；同时将 comtypes.client.gen_dir 置空，使 COM 包装仅在内存中生成，避免某些中文版类型库触发 comtypes 的 mbcs 磁盘缓存解码错误。
如果类型库在 import 时加载失败（例如 ZWCAD 尚未启动），ZwCADMech.zwm_app 属性在首次访问时会自动调用 reload_typelib() 重试加载。也可通过 zwcad_mech_diagnose 工具触发重新诊断。
如果类型库无法自动加载（如自定义安装路径），可在 MCP 配置中设置 PYZWCADMECH_TLB_PATH 环境变量，指向实际的 ZwmToolKit.tlb：
{
"mcpServers": {
"zwcad": {
"command": "uvx",
"args": ["zwcad-mcp"],
"env": {
"PYTHONUTF8": "1",
"PYZWCADMECH_TLB_PATH": "C:\\Program Files\\ZWSOFT\\<中望机械安装目录>\\Zwcadm\\ZwmToolKit.tlb"
}
}
}
}路径中的安装目录名随版本变化（形如
ZWCAD Mechanical <年份> Chs），请按本机实际安装目录填写；可用zwcad_get_app_info(scope="mech_zwm_path")查询真实路径。
工具 | 类型库未加载时 | 说明 |
| ❌ 不可用 | 返回 |
| ❌ 不可用 | 返回 |
| ❌ 不可用 | 返回错误并附带修复提示 |
| ❌ 不可用 | 返回错误并附带修复提示 |
| ✅ 可用 | 通过 late binding 工作 |
| ✅ 可用 | 通过 late binding 工作 |
| ✅ 可用 | 通过 late binding 工作 |
| ✅ 可用 | 通过 late binding 工作 |
所有 pyzwcad 基础工具（绘图/标注/变换/查询等） | ✅ 可用 | 完全不依赖类型库 |
在 Cursor / Claude Desktop / WorkBuddy 中，告诉 AI：
"在中望机械CAD中，创建一个A3横向图框，GB标准，包含标题栏和附加栏"
AI 会自动调用 zwcad_mech_create_frame 工具：
zwcad_mech_create_frame(
frame_size_name="A3",
orientation="landscape",
std_name="GB",
have_btl=True,
have_fjl=True
)server.py # MCP Server 主程序（39 个工具）
hatch_info.py # 剖面线边界环提取（COM + LISP 回退）
README.md
LICENSE
THIRD_PARTY_NOTICES.mdAI 客户端（Cursor / Claude Desktop / WorkBuddy / 任意 MCP 客户端）
│
│ MCP 协议（stdio, JSON-RPC）
▼
FastMCP Server（入口: src/server.py, 39 个工具）
│
├── pyzwcad ──────► ZWCAD.Application COM API（平台绘图/标注/变换/查询）
│ └── 不依赖类型库，始终可用
│
└── pyzwcadmech ──► ZwmToolKit COM API（机械功能）
│
├── 类型库加载（5级回退策略）
│ ├── 1. 文件 glob（版本感知排序）
│ ├── 2. PYZWCADMECH_TLB_PATH 环境变量
│ ├── 3. 本地路径
│ ├── 4. 预生成 comtypes.gen 模块
│ └── 5. GUID 注册表加载
│
├── ZwmApp ──── 应用层（版本/路径/文档操作）── 不依赖类型库
├── ZwmDb ──── 数据库层（打开/保存/图框管理）
│ ├── open_file/save/close/switch_frame ── 不依赖类型库
│ ├── get_title() ──► ZwmTitle ── 依赖类型库
│ ├── get_bom() ────► ZwmBom ─── 依赖类型库
│ └── get_frame() ──► ZwmFrame ─ 依赖类型库
│
└── 运行时重试: zwm_app 属性在 ZWM=None 时自动调用 reload_typelib()
连接缓存: get_cad_connection() 缓存 (ZwCAD, ZwCADMech) 实例，自动处理失效重连
诊断工具: zwcad_diagnose / zwcad_mech_diagnose 每次调用自动重置连接缓存，逐项探测ZWCAD 必须运行：所有工具调用都要求 ZWCAD（或中望机械CAD）已启动并打开了 DWG 文件。
单活动实例策略：同一时间只操作一个 ZWCAD 系列实例。多个 ZWCAD/机械实例并存时，Windows COM 可能连接到非预期实例。
样式文件路径：zwcad_mech_create_frame 工具从 XML 配置文件读取默认样式，路径形如 C:\Users\Public\Documents\ZWSoft\zwcadm\<版本>\<语言>\styles（<版本> 与 <语言> 取决于本机安装的中望机械版本，例如 2026 版简体中文为 2026\zh-CN）
类型库加载：机械模块（标题栏/明细表/图框）依赖 ZwmToolKit 类型库。正常安装环境下会自动加载；如遇加载失败，可使用 zwcad_mech_diagnose 工具诊断，或设置 PYZWCADMECH_TLB_PATH 环境变量指向 ZwmToolKit.tlb 文件。
连接缓存：MCP Server 会缓存 CAD 连接实例以提高性能。zwcad_diagnose / zwcad_mech_diagnose 工具每次调用会自动重置缓存以获取最新状态。
写入操作需人工确认：删除实体、覆盖保存、关闭文档、替换插件、修改系统变量等写操作会直接改变当前 DWG，调用前请先备份图纸。
以下依赖由 pip install zwcad-mcp 或 uvx zwcad-mcp 自动安装，无需手动处理：
pyzwcad - ZWCAD Python COM 封装
pyzwcadmech >=0.3.0 - 中望机械 Python COM 封装
FastMCP - MCP 协议服务框架
comtypes - COM 类型库加载与接口调用
pywin32 - Windows COM 初始化支持
第三方组件的许可声明见随包提供的 THIRD_PARTY_NOTICES.md。
本项目采用 MIT 许可，详见 LICENSE。
This server cannot be deployed
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
Build and run automations across 2,300+ apps and build app integrations from any MCP client.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.