DWG MCP Server

DWG MCP Server

DWG and DXF file format access for AI via MCP.

Connect DWG and DXF files to Claude, ChatGPT, Codex, Cursor, and other MCP clients. DWG MCP Server provides structured access to DWG data so AI can understand and reason about drawings. Source files remain read-only; supported entity properties can be changed in memory for inspection and rendering.

Quick Start

Use DWG MCP Server from the MCP client of your choice. The npm package downloads the matching native build from GitHub Releases on first use, verifies its SHA-256 checksum, caches it, and runs it directly. Docker and a separate Python installation are not required.

If your MCP client, AI agent, or test harness does not support MCP roots, set DWGMCPALLOWED_ROOTS to the folders that should be accessible.

Codex

codex mcp add dwg-mcp \
  --env DWG_MCP_ALLOWED_ROOTS="$HOME" \
  -- npx -y @dmytro-prototypes/dwg-mcp-server

Codex does not currently provide MCP client roots to stdio MCP servers. Configure explicit allowed roots for the folders that contain your drawings.

Claude

claude mcp add --scope user --transport stdio dwg-mcp -- npx -y @dmytro-prototypes/dwg-mcp-server

Claude Code provides MCP roots, so no extra path variable is usually needed.

Cursor

{
  "mcpServers": {
    "dwg-mcp": {
      "command": "npx",
      "args": ["-y", "@dmytro-prototypes/dwg-mcp-server"]
    }
  }
}

Exposed Tools

A typical flow is:

1. Discover available folders with dwg.list_roots.
2. Open a file from one of those folders with dwg.open_file.
3. Inspect supported or file-local types with dwg.listtypes, dwg.listfiletypes, or dwg.describetype.
4. Fetch known handles with dwg.getobjects or search the drawing with dwg.queryobjects.
5. Optionally change properties reported as writable with dwg.setentityproperties.
6. Discover and render drawing views with dwg.listrenderviews and dwg.render_view.
7. Close the session with dwg.close_file, discarding in-memory changes.

Architecture

Runtime model

In the packaged deployment, DWG MCP Server is a standalone native application built for the host operating system. The Python host exposes the MCP tools, validates file access, and manages document sessions.

Each dwg.openfile call starts a dedicated Rust dwg-worker process for that DWG and returns a host-side documentId. All later file-scoped calls use that document id. dwg.closefile terminates the worker for that session.

Worker and query model

Shortened. The full README is on GitHub.