ZWCAD机械版 CAD MCP Server — 43个高度整合的工具，让AI通过MCP协议全面操控中望机械CAD，支持2D/3D绘图、标注、图块、图层样式、表格、对象编辑变换、图框/标题栏/明细表管理、机械符号标注（粗糙度/公差框/基准/焊接/气泡）、后端自动回退、视图控制与命令行执行等完整CAD自动化能力 |MCP服务器用于ZWCAD MFG — 43...
概览
中望机械CAD自动化 MCP 服务，让大模型通过 MCP 协议直接操控中望机械CAD完成绘图、编辑标题栏、管理图框和明细表等操作。 https://github.com/user-attachments/assets/827604ac-3e79-47f8-8655-71bd306c33cb https://github.com/user-attachments/assets/489ec032-c238-4d7f-8d69-bb894ef1b40b - ： Windows 10/11 - ： 中望机械CAD 2026 已安装并运行 - ： 3.10+（FastMCP 2.x 起要求 Python 3.10 及以上） 最简单的安装MCP方法：打开Agent，在里面输入：安装上此MCP服务： https://github.com/john0909/ZWCAD-Mechanical-MCP 默认 ZWMECH_USE_ZRX=0，机械功能优先使用 pyzwcadmech;如果 ZwmToolKit COM 接口不可用，服务会通过活动 ZWCAD 的 Application.LoadZrx（） 自动加载 ZWMechMCP.zrx 并回退到本机桥接。将 ZWMECH_USE_ZRX 设为 1（也接受 true/on/yes）可强制所有机械功能直接走 ZRX。 编辑 ~/AppData/Roaming/Claude/claude_desktop_config.json： （add_dimension 与 modify_entity（entity_type=“dimension”） 通用，均放在 params 中，可选）：
概述（AI 翻译）
中文 |英语
中望机械CAD自动化 MCP 服务，让大模型通过 MCP 协议直接操控中望机械CAD完成绘图、编辑标题栏、管理图框和明细表等操作。
演示视频
https://github.com/user-attachments/assets/827604ac-3e79-47f8-8655-71bd306c33cb
绘制渐开线直齿圆柱齿轮示例
https://github.com/user-attachments/assets/489ec032-c238-4d7f-8d69-bb894ef1b40b
功能概览
| 分类 | 工具数 | 说明 |
|---|---|---|
| 绘图 | 3 | draw_entity（2D）draw_batch（批量）、draw_3d_solid（3D） |
| 注释与标注 | 3 | add_annotation、add_dimension、insert_block |
| 实体操作 | 4 | transform_entity、modify_entity、get_entity_info、set_entity_properties |
| 对象查询 | 3 | find_object、get_objects_in_model、query_dimensions |
| 样式管理 | 1 | manage_style（图层/线型/文字/标注样式 CRUD） |
| 视图与布局 | 2 | manage_view]zoom |
| 文档管理 | 1 | manage_document |
| 表格操作 | 1 | manage_table |
| 选择集 | 1 | select_entities |
| 图块管理 | 1 | manage_block |
| 系统工具 | 3 | get_variable、set_variable、get_app_info |
| 诊断工具 | 1 | mech_diagnose（机械后端、ZRX 桥接与连接诊断） |
| 标题栏 | 1 | manage_title_block |
| 图框 | 2 | manage_frame]create_frame |
| 明细表 | 2 | manage_bom]create_partlist |
| 机械数据库 | 1 | manage_mech_db |
| 机械应用 | 4 | mech_doc、cad_environment_init、get_balloon、insert_balloon |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
ZWCAD机械版 MCP Server
中望机械CAD自动化 MCP 服务，让大模型通过 MCP 协议直接操控中望机械CAD完成绘图、编辑标题栏、管理图框和明细表等操作。
演示视频
https://github.com/user-attachments/assets/827604ac-3e79-47f8-8655-71bd306c33cb
绘制渐开线直齿圆柱齿轮示例
https://github.com/user-attachments/assets/489ec032-c238-4d7f-8d69-bb894ef1b40b
功能概览
| 分类 | 工具数 | 说明 |
|---|---|---|
| 绘图 | 3 | draw_entity（2D）、draw_batch（批量）、draw_3d_solid（3D） |
| 注释与标注 | 3 | add_annotation、add_dimension、insert_block |
| 实体操作 | 4 | transform_entity、modify_entity、get_entity_info、set_entity_properties |
| 对象查询 | 3 | find_object、get_objects_in_model、query_dimensions |
| 样式管理 | 1 | manage_style（图层/线型/文字/标注样式 CRUD） |
| 视图与布局 | 2 | manage_view、zoom |
| 文档管理 | 1 | manage_document |
| 表格操作 | 1 | manage_table |
| 选择集 | 1 | select_entities |
| 图块管理 | 1 | manage_block |
| 系统工具 | 3 | get_variable、set_variable、get_app_info |
| 诊断工具 | 1 | mech_diagnose（机械后端、ZRX 桥接与连接诊断） |
| 标题栏 | 1 | manage_title_block |
| 图框 | 2 | manage_frame、create_frame |
| 明细表 | 2 | manage_bom、create_partlist |
| 机械数据库 | 1 | manage_mech_db |
| 机械应用 | 4 | mech_doc、cad_environment_init、get_balloon、insert_balloon |
| 机械符号标注 | 6 | manage_surf_sym、manage_fc_frame、manage_datum_id、manage_note、manage_welding、manage_bubble |
| 扩展数据 | 3 | manage_dictionary、manage_xdata、manage_utility |
共计 43 个工具
系统要求
- 操作系统: Windows 10/11
- CAD 软件: 中望机械CAD 2026 已安装并运行
- Python: 3.10+（FastMCP 2.x 起要求 Python 3.10 及以上）
快速开始
最简单的安装MCP方法：打开Agent，在里面输入:安装上此MCP服务: https://github.com/john0909/ZWCAD-Mechanical-MCP
1. 安装依赖
pip install -r requirements.txt
2. 启动中望机械CAD
确保中望机械CAD 2026 已启动并打开了一个 DWG 文件。
3. 启动 MCP Server
python server.py
或使用一键启动脚本：
start.bat
默认 ZWMECH_USE_ZRX=0，机械功能优先使用 pyzwcadmech；如果 ZwmToolKit COM 接口不可用，服务会通过活动 ZWCAD 的 Application.LoadZrx() 自动加载 ZWMechMCP.zrx 并回退到本机桥接。将 ZWMECH_USE_ZRX 设为 1（也接受 true/on/yes）可强制所有机械功能直接走 ZRX。
4. 配置 MCP 客户端
Cursor
在项目根目录创建 .cursor/mcp.json，或编辑全局配置：
{
"mcpServers": {
"zwcadmech": {
"command": "python",
"args": ["path/to/zwcad-mechanical-mcp-server/server.py"]
}
}
}
Claude Desktop
编辑 ~/AppData/Roaming/Claude/claude_desktop_config.json：
{
"mcpServers": {
"zwcadmech": {
"command": "python",
"args": ["path/to/zwcad-mechanical-mcp-server/server.py"]
}
}
}
Qoder
参考 mcp-config.json 进行配置。
工具详细说明
绘图工具
| 工具 | 说明 | entity_type / solid_type |
|---|---|---|
draw_entity |
绘制2D实体 | line, circle, arc, ellipse, lwpolyline, polyline, spline, point, ray, xline, mline, 3d_polyline |
draw_batch |
批量绘制多种实体 | 支持上述2D实体与3D实体的混合批量绘制 |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"zwcadmech": {
"command": "python",
"args": ["path/to/zwcad-mechanical-mcp-server/server.py"]
}
}
}