# autocad-mcp

> 用自然语言操控 AutoCAD 的 MCP 服务器：Claude 直接画图改图、标注、出 PDF，支持无 AutoCAD 的 ezdxf 无头后端

## autocad-mcp —— 用自然语言操控 AutoCAD 的 MCP 服务器

autocad-mcp 是一个开源的 MCP（Model Context Protocol）服务器，让 Claude Desktop、Claude Code 等 AI 客户端通过**自然语言直接驱动 AutoCAD**——画图、改图、标注、出 PDF，说句话就能完成。GitHub 400+ 星，MIT 协议。

### 双后端架构

| 后端 | 运行环境 | 需要装 AutoCAD？ | 截图方式 |
|------|---------|-----------------|---------|
| **File IPC** | Windows Python | 需要 AutoCAD LT 2024+（Windows） | Win32 PrintWindow |
| **ezdxf** | 任意平台 | 不需要（无头模式离线生成 DXF） | matplotlib 渲染 |

没有 AutoCAD 的机器也能用 ezdxf 后端离线生成/编辑 DXF 文件。

### 功能（8 大工具组）

- **drawing**：新建/打开/保存图纸、导出 DXF、打印 PDF、undo/redo
- **entity**：创建直线、圆、多段线、矩形、圆弧、椭圆、多行文字、填充；复制、移动、旋转、缩放、镜像、偏移、阵列、圆角、倒角
- **layer**：图层创建、冻结/解冻、锁定/解锁、属性设置
- **block**：块插入（含属性块）、属性读写、块定义
- **annotation**：文字、线性/对齐/角度/半径标注、引线
- **pid**：P&ID 工艺流程图符号库（阀门、仪表、泵、罐体、流程线、设备位号）
- **view**：缩放视图、截取当前 AutoCAD 画面为 PNG（AI 可以"看到"图纸）
- **system**：状态查询、自由执行 AutoLISP 代码

### 使用教程

```powershell
# 1. 克隆并安装（需要 Python 3.10+ 和 uv 包管理器）
git clone https://github.com/puran-water/autocad-mcp.git
cd autocad-mcp
uv sync
```

2. 在 AutoCAD LT 中执行 `APPLOAD`，加载 `lisp-code/mcp_dispatch.lsp`（可加入启动组自动加载）

3. 在 Claude Desktop 配置文件中添加：

```json
{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\path\\to\\autocad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "autocad_mcp"],
      "env": { "AUTOCAD_MCP_BACKEND": "auto" }
    }
  }
}
```

4. 验证：让 Claude 调用 `system(operation="status")`，显示 `file_ipc` 即连接成功

### 注意事项

- File IPC 后端需要 **Windows 10/11 + AutoCAD LT 2024 或更新**（LT 2024 起才支持 AutoLISP；Mac 版 LT 不支持）
- 配套技能包：[puran-water/autocad-drafting](https://github.com/puran-water/autocad-drafting)，让 AI 更懂制图规范
- MCP 客户端跑在 WSL 里也可以，通过 `cmd.exe` 桥接启动（README 有配置示例）

---

**分类**：软件
**标签**：autocad · AutoCAD · mcp
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1936