CAD-MAX
Connects to AutoCAD for read-only status and health checks, with future capabilities for DWG file operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CAD-MAX what is the status of the current drawing?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CAD-MAX
CAD-MAX is a safety-first foundation for connecting an MCP client to AutoCAD through a Python MCP server and a localhost C# bridge.
Current version: 0.1.0. Phase 0 repository bootstrap is complete. Phase 1 is active; its plan/governance batch is accepted, and the plugin-bootstrap batch has not started.
Project governance / 项目治理
当前 Phase、下一允许动作和安全能力状态以
current status 顶部的 cad-max-current-authority 区块为唯一
authority。事实源职责、文档预算、验证证据和 CI 生命周期见
current docs。任何 CI 绿色都不表示真实 AutoCAD 或 DWG 能力已实现。
Related MCP server: CDT AutoCAD Provider
Current real completion
Implemented now:
Python 3.12 package cad-max-mcp with stdio and Streamable HTTP transports.
MCP tools cad_system for health, version, and capabilities.
MCP tool drawing with the read-only status operation.
NullCadBackend for machines without AutoCAD.
AutoCadBridgeBackend with bounded localhost HTTP calls and structured failures.
Shared versioned JSON contracts and matching Python/C# models.
.NET 8 bridge dispatcher, localhost development Host, and test suite.
A compilable net8.0-windows AutoCAD plugin boundary with no Autodesk references.
Read-only, write-disabled, script-disabled, loopback-only defaults.
Not implemented:
Real AutoCAD attachment.
Reading a live drawing.
Creating, modifying, saving, exporting, or validating DWG content.
Any script, AutoLISP, arbitrary code, write, or remote-network tool.
CAD-MAX does not currently modify DWG files. When no bridge is configured, drawing status returns BACKEND_NOT_CONFIGURED. The development bridge has no AutoCAD command handlers, so an unknown command returns NOT_IMPLEMENTED rather than fake success.
Architecture
MCP client
|
| stdio or Streamable HTTP at 127.0.0.1:47771/mcp
v
Python cad-max-mcp
|
| localhost HTTP and versioned JSON
v
C# CadMax.Bridge.Host at 127.0.0.1:47770
|
| future AutoCAD Managed .NET API adapter
v
AutoCAD 2025 or 2026 plugin
|
v
2D DWG document contextPython owns the MCP protocol and client-facing validation. C# will own all future AutoCAD execution because Autodesk's supported managed API, application context, and document context belong inside the AutoCAD process. See Architecture and ADR 0001.
Supported baseline
Windows 10 or 11 for the future AutoCAD bridge.
Python 3.12.
uv.
.NET 8 SDK.
AutoCAD 2025 or 2026 for future plugin integration.
2D DWG scope only.
AutoCAD 2024, AutoCAD LT, ZWCAD, GstarCAD, Tianzheng, SolidWorks, FreeCAD, 3D modeling, and cloud batch processing are explicitly outside this phase.
Local setup
Install Python 3.12, uv, and the .NET 8 SDK. Then run:
uv sync --frozen
uv run cad-max-mcp doctorThe doctor command emits structured JSON and returns exit code 0 when the safe base configuration is valid.
Start the MCP server
Stdio:
uv run cad-max-mcp serve --transport stdioStreamable HTTP:
uv run cad-max-mcp serve --transport streamable-httpThe HTTP endpoint is http://127.0.0.1:47771/mcp. Configuration rejects 0.0.0.0 and other non-loopback hosts.
PowerShell wrappers are also available:
.\scripts\run-mcp-stdio.ps1
.\scripts\run-mcp-http.ps1Start the development bridge
The bridge does not require AutoCAD and exposes only health, capabilities, and a fail-closed command dispatcher:
dotnet run --project src/dotnet/CadMax.Bridge.HostEndpoints:
No CAD command handler is registered in Phase 0.
Test and verify
Python:
uv sync --frozen
uv run ruff check .
uv run ruff format --check .
uv run mypy src/python
uv run pytest.NET:
dotnet restore src/dotnet/CadMax.sln --locked-mode --configfile NuGet.Config
dotnet build src/dotnet/CadMax.sln --configuration Release --no-restore
dotnet test src/dotnet/CadMax.sln --configuration Release --no-buildUnified PowerShell verification:
.\scripts\verify.ps1The script stops with a non-zero exit code on the first failed check.
MCP client configuration example
Replace the path with your local checkout:
{
"mcpServers": {
"cad-max": {
"command": "uv",
"args": [
"--directory",
"C:\\path\\to\\CAD-MAX",
"run",
"cad-max-mcp",
"serve",
"--transport",
"stdio"
]
}
}
}More examples are in MCP client setup.
Configuration and safe defaults
Environment variables use the CAD_MAX_ prefix. The committed .env.example contains names and safe example values only. A real .env file is ignored and is not loaded implicitly by the application.
readOnly is true.
allowWrite is false.
allowScript is false.
httpHost is 127.0.0.1.
allowedRoots is empty.
bridgeUrl is unset.
Future file operations must normalize an absolute path and prove it is inside an allowed root. An empty allowlist grants no file access.
Why Autodesk DLLs are not in this repository
AcDbMgd.dll, AcMgd.dll, AcCoreMgd.dll, Autodesk SDK files, and AutoCAD redistributables are proprietary and installation-specific. They must be referenced from a licensed local AutoCAD installation through uncommitted machine-local MSBuild configuration. CI does not install AutoCAD and does not need these DLLs. See AutoCAD SDK setup.
Security warning
CAD automation can alter valuable drawings. Keep the HTTP services on loopback, keep writes and scripts disabled, never expose the development Host through a tunnel, and work on backed-up test drawings when a future write phase is enabled. See Security model.
Roadmap
The ordered delivery plan is in ROADMAP.md. Phase 1 will establish a real AutoCAD 2025/2026 connection and lifecycle boundary without enabling arbitrary DWG editing. The executable read-only scope and numbered work batches are in the Phase 1 AutoCAD Connection plan; that plan does not replace current authority.
License
MIT. See LICENSE.
Available Tools
2 toolscad_systemC
Inspect health, version, or the truthful capability inventory.
Inputs: operation (required). Returns: data, status, message, success, +6 more
drawingC
Inspect only allowlisted read-only document metadata through the AutoCAD bridge.
Inputs: operation (required), deadline_ms, expected_document_id, expected_instance_id. Returns: data, status, message, success, +6 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
cad_system targets server health/version/capability inventory, while drawing targets allowlisted read-only document metadata. They are mostly distinct, though both are read-only inspection tools and could be momentarily confused.
The names use mixed conventions: cad_system is a prefixed snake_case compound, while drawing is a bare noun. Both are readable, but there is no consistent verb_noun or noun_noun pattern.
Two tools is far too thin for a CAD server; the surface only supports introspection and metadata inspection. It lacks the operation breadth expected for CAD-MAX.
The server only exposes system health and read-only drawing metadata, with no create, modify, delete, export, or geometry query operations. This is severely incomplete for a CAD domain.
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Global CAD/BIM, industrial engineering (FEM, CFD) and property tools via one MCP endpoint.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for full AutoCAD automation, AutoCAD LT automation, and headless DXF generation. It provides 8 consolidated tools for drawing, entity, layer, block, annotation, P&ID, view, and system operations via MCP stdio transport.1247MIT
- AlicenseAqualityBmaintenanceEnables MCP-based interaction with AutoCAD and DXF/DWG drawings, supporting document lifecycle, entities, layers, blocks, layouts, viewports, zoom, screenshot capture, and PDF export via ezdxf or live Windows AutoCAD COM backends.87MIT
- FlicenseBqualityBmaintenanceNatural-language MCP bridge for AutoCAD 2024. Enables users to inspect and edit DWG drawings, manage layers, entities, layouts, styles, and system variables; draw 2D geometry and 3D solids; perform measurements and transactional edits; and export to DWG, STL, PDF, DWF, SVG, or raster formats through a local named-pipe connection.211-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to connect to and automate AutoCAD on Windows via COM, exposing tools to inspect drawings and layers, create geometry and text, manage system variables, run commands, and save or open drawings. Requires full AutoCAD running with a drawing open.2MIT