autocad-mcp

MCP (Model Context Protocol) server that exposes the AutoCAD .NET API database to AI coding tools such as Claude Code, Cursor, and Copilot.

Requirements

• Node.js ≥ 18
• A running cad-backend instance with an AutoCAD SQLite index loaded

Usage

With Claude Code

# Set the backend URL (default: http://127.0.0.1:9222)
set AUTOCAD_BACKEND_URL=http://your-server:9222

claude mcp add --transport stdio --scope local autocad -- npx autocad-mcp
# or with explicit backend
claude mcp add --transport stdio --scope local autocad -- npx autocad-mcp --backend http://your-server:9222

Version auto-detection

The server detects the AutoCAD version in this order:

1. acdbmgd.dll ProductVersion found in the project tree (major 22 → 2018, 23 → 2019, …)
2. .acad-version file in the project root (written automatically after first use)
3. Backend has exactly one version loaded → auto-selected
4. Prompts the user — Claude will ask which version to use, then call acad_set_version

Once set, the version is saved to .acad-version and reused in future sessions.

Tools

| Tool | Description | |---|---| | acad_set_version | Set the AutoCAD version for this project (persisted to .acad-version) | | acad_index_status | Status of loaded AutoCAD SQLite indexes | | acad_get_project_context | Detect AutoCAD C# project context | | acad_hybrid_search_api | Natural-language API search | | acad_get_type | Look up a type by full name | | acad_get_members | List members of a type | | acad_get_method_signature | Get method overload signatures | | acad_validate_symbols | Validate AutoCAD symbols in C# code |

Backend

See cad-backend on PyPI for setup instructions.

License

MIT