内容
# vn-autocad-claude
> 🇻🇳 **越南语:** 请在 **[README](README.vi.md)** 中查看完整指南。
一个 MCP 服务器，Claude**（Claude Code 和 Claude Desktop）控制 **AutoCAD绘制、编辑、查询、图层、块、注释、截图、打印到 PDF — 使用纯语言 上支持 **完整 AutoCAD **AutoCAD LT 2024+**，在 macOS/Linux 上通过 `ezdxf` 后无头运行（无需 AutoCAD）**。
本项目是 [puran-water/autocad-mcp](https://github.com/puran-water/autocad-mcp) 的越南语友好版本（MIT 许可）。参见 [NOTICE](NOTICE) 了解更改列表。由 [@andyluu98](https://github.com/andyluu98) 维护。
---
列表
| 后端 | 平台 | 需要运行 AutoCAD？ | 功能 |
|---------|----------|------------------------|--------------|
| **文件 IPC** | Windows | 是 — 完整 AutoCAD 或 LT **2024+** | 控制当前打开的绘图 |
| **ezdxf**（无头） | Windows / macOS / Linux | 否 | 直接读写 `.dxf` 文件 |
`AUTOCAD_MCP_BACKEND=auto`（默认）会在CAD 窗口时选择文件 IPC，否则会回退到无头 ezdxf。
> 在 **macOS** 上，AutoCAD 不LISP/COM，因此使用 **ezdxf** 后端。这足以从 Claude 生成和dxf` 绘图## 要求
- **Python 3.10+**
- **[uv](https://docs.astral.sh/uv/)** 包管理器 **Git**
- 对于实时（文件 IPC）后端：**Windows 10** + **AutoCAD 2024+ 或 AutoCAD LT 2024+**
---
## 快速安装
### Windows（PowerShell）
```powershell
git clone https://github.com/andyluu98/vn-autocad-claude.git
cd vn-autocad-claude
./scripts/install.ps1
```
### macOS / Linux
```bash
git clone https://github.comuu98/vn-autocad-claude.git
cd vn-autocad-claude
./scripts/install.sh
```
安装脚本会运行 `uv sync` 并打印适用于您机器的 MCP 配置行。
---
## 连接到 Claude
### Claude Code（CLI）
```bash
claude mcpad-mcp -- \
--env AUTOCAD_MCP_BACKEND=auto \
--SOLUTE_PATH>/vn-aut-claude/.venv/<bin-or-Scripts>/python<.exe>" -m autocad_mcp
```
- Windows 虚拟环境 Python...\.venv\Scripts\python.exe`
- macOS/Linux 虚拟环境 Python：`.../.venv/bin/python`
安装脚本会打印完整的行供您复制。
### Claude Desktop
添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"autocad-mcp": {
"command": "<ABSOLUTE_PATH>/vn-autocad-claude/.venv/Scripts/python.exe",
"args": ["- "autocad_mcp"],
"env": { "AUTOCAD_MCP_BACKEND": "auto" }
}
}
}
```
在 macOS/Linux 上使用 `.venv/bin/python`（无 `.exe`）。
---
## 在 AutoCAD 中加载调度程序（仅适用于实时后端）
1. 打开 AutoCAD 并打开/创建。
2. 在命令行中，输入 **`APPLOAD`** → 加载 `lisp-code/mcp_dispatch.lsp`。您应该会看到 `=== MCP Dispatch v3.1 loaded ===`。
3. 要加载：`OPTIONS` → **文件** → **受信任 → 添加 `lisp-code` 文件夹，然后将 `mcp_dispatch.lsp` 添加到 **启动套件**（APPLOAD → 内容）。
快速手动加载替代方法（在 AutoCAD 命令行中）：
```
(load "<ABSOLUTE_PATH>/vn-autocad-claude/lisp-code/mcp_dispatch.lsp")
```
---
## 验证
重启 Claude，然后要求它调用 `system(operation="status")`。您应该会得到
`{"ok": true, "backend": "file_ipc" | "ezdxf"}`。
然后尝试：*"在原点绘制一个半径为 50 的圆"*。
---
## 故障排除
完整攻略（也可由 Claude Code 自身读取）： **[CLAUDE.md](CLAUDE.md)**。
| 症状 | 解决方法 |
|---------|-----|
| `AutoCAD 检测到但 mcp_dispatch.lsp 未加载` | 重新 `APPLOAD`；保持 AutoCAD 打开；重启 Claude。 |
| `找不到 窗口` | 打开带有绘图的 AutoCAD，否则将zdxf 后端。 |
| 完整 AutoCAD 上的命令超时 | COM 触发器应处理此问题；确保绘图活动状态且 LISP 已加载。 |
| `uv sync` 在 macOS 上失败，原因是 pywin32 | `pywin仅适用于 Windows 且已受到保护；更新 `uv` 并重试。 |
---
## 隐私
此存储库**不包含图个人数据**。
IPC 工作目录为 `C:\temp`（Windows）— 您的 `.dwg`/`.dxf` 文件保留在您的机器上，并被 git 忽略。永远不要提交 `claude_desktop_config.json` 或 `.env`。
## 许可证
MIT — 参见 [LICENSE](LICENSE)。根据上游项目保留原始版权。
