AutoCAD MCP

通过 MCP（Model Context Protocol）让 AI 客户端（Claude Desktop / Cursor 等）用自然语言控制 AutoCAD 绘图。参考并改进自 daobataotie/CAD-MCP（差异见 docs/references/cad-mcp-analysis.md）。

环境要求

• Windows + 已安装 AutoCAD（本项目在 AutoCAD 2026 上开发，ProgID AutoCAD.Application.25.1，见 src/autocad_mcp/config.json）
• conda

快速开始

conda activate autocad-mcp
# 打开 AutoCAD 2026，然后：
mcp dev src/autocad_mcp/server.py    # 用 MCP Inspector 调试

接入 Claude Desktop：在 claude_desktop_config.json（Windows 上一般是 %APPDATA%\Claude\claude_desktop_config.json）里加入 mcpServers：

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\Users\\<用户名>\\.conda\\envs\\autocad-mcp\\python.exe",
      "args": ["-m", "autocad_mcp.server"]
    }
  }
}

（command 直接指向 conda 环境里的 python.exe，不要用 conda run -n autocad-mcp ...——后者在 Claude Desktop 拉起子进程时可能拿不到 conda 的 shell 初始化环境，也更容易碰到 Windows 控制台编码问题。前提是已经 pip install -e . 把本项目装进这个环境。）

网页 UI（自己选大模型，仍走 MCP 协议）

除了接 Claude Desktop，也可以用自带的网页界面，自己填 API Key、自己选大模型（Claude / OpenAI / OpenAI 兼容的国产模型如通义千问/DeepSeek/智谱）。网页后端是一个自建的 MCP client，通过 HTTP 连接 AutoCAD MCP server——cad//tools/ 两层完全复用，不是绕开 MCP 直接调 Python 函数。

先装网页相关依赖（装进同一个 autocad-mcp conda 环境）：

"C:\Users\<用户名>\.conda\envs\autocad-mcp\python.exe" -m pip install anthropic openai fastapi "uvicorn[standard]"

需要同时起两个进程（项目根目录下执行，web 包不是通过 pip 装的，靠 -m 的当前目录解析）：

# 终端 1：AutoCAD MCP server，HTTP 模式，供网页后端连接（不影响 Claude Desktop 的 stdio 配置）
"C:\Users\<用户名>\.conda\envs\autocad-mcp\python.exe" -m autocad_mcp.server --http

# 终端 2：网页后端
"C:\Users\<用户名>\.conda\envs\autocad-mcp\python.exe" -m uvicorn web.backend.app:app --port 8000

打开 http://127.0.0.1:8000，选模型、填 API Key（只在当次请求里用，不落盘不写日志）、用自然语言聊天即可。这是本地单用户场景的简化实现：会话历史存在后端进程内存里（重启即丢），没有鉴权，只适合本机 127.0.0.1 访问，不要暴露到公网。

项目结构

见 docs/design/architecture.md。

开发文档 / 日志

• 设计方案：docs/design/
• 参考项目分析：docs/references/
• 开发日志（每次改动都会更新）：docs/logs/devlog.md