1. 为什么要在本地跑 multiCAD-mcp 控制中望 CAD如果你每天的工作里有一部分是重复画图——比如固定尺寸的矩形房间、标准图层的新建、批量标注——那你大概想过能不能让 AI 直接帮我在 CAD 里落笔而不是我一句句描述、它一段段给代码、我再复制粘贴到命令行multiCAD-mcp 就是干这个的。它是一个跑在 Windows 本地的 MCP 服务把 WorkBuddy 这类 AI 客户端的自然语言指令翻译成中望 CAD 能听懂的 COM 调用最终在模型空间里真正画出图元。图纸画面只出现在 CAD 窗口里AI 对话框看不到但指令确实被执行了。这套链路适合谁适合已经装了中望 CAD 完整版、想把手上的重复绘图动作交给 AI 的工程师和设计岗也适合想研究 MCP 协议怎么和桌面软件打通的开发者。它不适合 macOS 和 Linux 用户因为根基是 Windows COM 接口跨平台无从谈起。另外绿色精简版 CAD 会缺 COM 组件连接必然失败这一点必须先确认。我试过把这套流程从零搭一遍踩的坑主要集中在路径、Python 环境和 pywin32 版本上。下面按“先讲清链路、再给可复制配置、最后验证出图”的顺序展开你可以跟着一步步做。核心检索词就三个multiCAD-mcp、WorkBuddy、中望 CAD 自动化绘图。搞懂这三者的关系后面就顺了。整条数据链路是这样的WorkBuddy 对话框里的自然语言 → multiCAD-mcp 本地服务Python 后台进程→ Windows COM 接口 → 你已经打开的中望 CAD → 在模型空间绘图 → DWG 由 CAD 自己保存。一句话AI 负责“下指令”multiCAD-mcp 负责“翻译”中望 CAD 负责“落笔”。理解了这个分工排错时你就知道该看哪一环。2. 前置准备TaoToken 与本地环境怎么配在正式拉源码之前先把两件事定下来一是 AI 侧的接入凭证二是本地 Python 环境。很多人卡在第一步是因为把 AI 客户端的模型接入和本地 MCP 服务混为一谈——它们其实是两层。WorkBuddy 负责对话和下发指令它背后需要一个稳定的模型接入通道multiCAD-mcp 负责把指令转成 COM 调用它跑在你本机。两层各配各的。模型接入这层我用的是 TaoToken 的 API 通道。它的 Base URL 是https://taotoken.net/api你需要在控制台生成一个 API Key然后在 WorkBuddy 的模型配置里填上 Base URL、Key 和 Model ID 这三件套。如果你用的是 Claude Code 这类编码工具做辅助也可以在它的配置里指向同一个 Base URL。生成 Key 的入口在控制台的 API Keys 页面接入文档里有各客户端的填写示例照着填就行。这一步不涉及任何网络工具就是标准的 API 配置。本地环境这层硬性约束先列清楚操作系统必须是 Windows 10 或 11 的 64 位版本CAD 必须是完整安装版中望 CAD 2026 属于 ZWCAD 2020 系列在 multiCAD-mcp 官方支持列表内可以放心用Python 选 3.10、3.11 或 3.12别用 3.14本文用 Anaconda 管理环境名取multicad另外需要 Git for Windows 来拉源码以及 WorkBuddy PC 客户端来承载对话和 MCP 连接器配置。存放源码的目录是坑最多的地方。路径里不能有中文、空格和特殊符号也别放在桌面上的中文文件夹里。我实际用的是C:\Users\Administrator\multiCAD-mcp\你也可以用C:\multiCAD-mcp\。路径含中文或空格后续 Python 和 COM 调用可能报编码错误或找不到文件这种错误很隐蔽提前规避比事后排查省事得多。环境校验再强调一次中望 CAD 必须是完整版。判断方法很简单完整版安装后在系统里能注册 COM 组件精简版往往把这部分裁掉了。如果你之前装的是绿色版建议直接卸载重装官方完整版否则后面连接成功却画不出图你会怀疑人生。3. 可复制配置源码、虚拟环境与 MCP 连接器这一节全是能直接复制的命令和配置路径按你自己的实际情况替换。先拉源码。进入目标目录在地址栏输入cmd回车打开终端逐条执行git clone https://github.com/AnCode666/multiCAD-mcp.git拉下来之后创建并激活虚拟环境。本文用 Anaconda环境名multicadPython 指定 3.11conda create -n multicad python3.11 -y conda activate multicad后续所有命令都必须在这个环境已激活的状态下执行。接着进源码目录装依赖并升级 COM 控制核心库 pywin32cd C:\Users\Administrator\multiCAD-mcp pip install . python -m pip install --upgrade pywin32pip install .会依据pyproject.toml安装 fastmcp、mcp、pywin32、openpyxl、pillow、fastapi、uvicorn、pydantic 等依赖。升级 pywin32 是强制步骤官方文档明确要求不升级可能导致 COM 调用异常。如果你习惯用 uv等价方案是先pip install uv再uv sync --dev最后uv run python -m pip install --upgrade pywin32。依赖装完先本地测一下 MCP 服务能不能起来。保持multicad环境激活执行python src/server.py终端会输出启动日志。只要没有 COM 相关报错、没有一闪而过地退出就说明本地环境正常。先别关这个终端下一步要在 WorkBuddy 里连它。现在配 WorkBuddy 的自定义 MCP 连接器。打开 WorkBuddy PC 客户端左侧菜单进“专家 · 技能 · 连接器 → 连接器”右上角点“自定义连接器 → 配置 MCP”在 JSON 编辑框里粘贴下面这段{ mcpServers: { multiCAD: { command: C:/ProgramData/miniconda3/envs/multicad/python.exe, args: [C:/Users/Administrator/multiCAD-mcp/src/server.py], disabled: false } } }保存后回到连接器列表确认 multiCAD 显示为已连接。路径写法有讲究Windows 下可以用正斜杠/如果用反斜杠\在 JSON 字符串里必须双写转义写成C:\\ProgramData\\miniconda3\\envs\\multicad\\python.exe。command一定要指向虚拟环境内的python.exe不要用系统py或全局 Python否则 pywin32 这些依赖会找不到。这里的 Base URL、Key、Model ID 三件套是给 WorkBuddy 的模型接入用的和 MCP 连接器是两套配置别填串了。4. 验证请求三轮实操让中望 CAD 真正出图配置对了不代表能出图必须实测。测试前先手动打开中望 CAD 2026新建一张空白 DWG 图纸窗口保持打开、不要最小化、不要关闭停留在模型空间。然后按三轮渐进测试来从最小验证到带门洞的小案例。第一轮最小测试只验证通路通不通。把下面这句话完整复制发给 WorkBuddy 的 AI调用multiCAD在CAD模型空间原点(0,0)画一个半径100的红色圆完成后告诉我执行结果发送后切回 CAD 看结果。如果模型空间原点出现一个半径 100 的红色圆说明 WorkBuddy → multiCAD-mcp → COM → 中望 CAD 这条链路全通了。这一轮不要加任何复杂条件越简单越好定位问题。第二轮图层加矩形加简单标注。发送调用multiCAD完成下面操作 1.新建图层【WALL】颜色白色置为当前图层 2.以(0,0)为角点绘制长5000宽3000的矩形房间 3.新建图层【DIM】蓝色用来做标注 4.给这个矩形做好长、宽的尺寸标注 完成后反馈操作情况切回 CAD 查看应该能看到 WALL 图层上的矩形以及 DIM 图层上的尺寸标注。尺寸标注相关能力以你实测的中望 CAD 2026 环境为准如果标注没出来先确认前两步的图层和矩形是否正常再单独排查标注。第三轮实操小案例房间带门洞。发送调用multiCAD 当前图层保持WALL绘制矩形房间8000*4000左下角坐标(100,100) 找到房间底边的中点使用CAD打断命令把底边中间900宽度的线段删除开出真实门洞 切换DIM图层标注房间总长总宽、门洞宽度 不要生成文字描述图纸直接在CAD执行绘图动作执行完毕告诉我。发送后切回 CAD 看最终效果。这一轮涉及打断命令和门洞宽度是对 COM 调用完整性的检验。三轮都跑通说明从配置到出图的闭环成立了。注意图纸画面只在 CAD 窗口里WorkBuddy 对话框看不到别在对话框里找图。5. 常见报错排查401、local proxy failed 与 COM 异常排错的核心思路是分层定位先看是 AI 接入层的问题还是本地 MCP 层的问题还是 CAD 本身的问题。下面按真实报错对照。如果你在 WorkBuddy 里看到 401 或鉴权失败那是模型接入层的问题跟 multiCAD-mcp 无关。检查 Base URL 是否填成https://taotoken.net/apiAPI Key 是否有效、有没有多余空格Model ID 是否和你在控制台看到的一致。这三件套任何一项错了都会 401。重新在控制台生成一个 Key 再试通常能解决。如果看到 local proxy failed 或连接被拒绝先确认python src/server.py那个终端还在跑、没有退出。MCP 服务是本地后台进程它没起来WorkBuddy 自然连不上。再看连接器 JSON 里的command路径是否指向multicad环境内的python.exeargs里的server.py路径是否正确。路径写错是最常见的原因。如果报reading choices之类的解析错误或者启动即报 COM 错误、找不到 CAD多半是 CAD 没先打开或者装的是精简版。先手动打开中望 CAD 并停在模型空间确认装的是完整版含 COM 组件。连接成功但画不出图基本就是精简版缺组件卸载重装官方完整版。pywin32 相关异常比如 COM 调用报错执行python -m pip install --upgrade pywin32升级。报编码错误或找不到文件检查源码路径是否含中文或空格把源码移到纯英文无空格路径比如C:\multiCAD-mcp\。终端一闪退出说明依赖没装全重新执行pip install .并确认没有报错。OAuth 相关的报错一般出现在模型接入层按 401 的思路检查凭证即可。6. 把 AI 遥控器接到中望 CAD 上之后整套方案的本质是给中望 CAD 2026 接上一个 AI 遥控器。WorkBuddy 负责理解你的自然语言指令multiCAD-mcp 把指令翻译成 CAD 能懂的 COM 调用中望 CAD 在模型空间里真正落笔DWG 由它自己保存。三个铁律记牢Windows 专属、CAD 必须完整版、pywin32 必升级。配合三轮渐进测试你就能把“对着 CAD 点菜单”变成“对着 WorkBuddy 说句话”。跑通之后可以往进阶方向走批量出图、参数化建模、从 Excel 读数据自动布图。这些玩法的前提都是这条链路稳定。如果你在接入或排障过程中卡住可以去 TaoToken 的接入文档对照配置或者用模型对话先验证模型通道是否正常长期做编码和 Agent 类任务的话Coding Plan 会更合适。先把最小闭环跑通再谈自动化这是我踩过坑之后最实在的建议。