Qcad MCP

What qcad-mcp does

The qcad-mcp MCP server exposes CAD operations for DXF and DWG workflows. It stores files in a persistent depot, lets an MCP client inspect drawing structure, and supports creating DXF files from lines, rectangles, circles, text, and polylines. Floor plans can be converted to SVG previews, measured, analysed for rooms and areas, or extruded into STL meshes with configurable wall height and thickness.

The server also includes a REST API. It supports file upload and download, depot listing and CRUD operations, health and status checks, MCP tool execution, live log streaming, settings management, and chat through Ollama. A web interface provides pages for the depot, viewer, extrusion, analysis, layers, blocks, scripts, batch jobs, pipelines, logs, and settings.

How the qcad-mcp MCP server works

The default CAD depot is %LOCALAPPDATA%\\qcad-mcp\\depot on Windows and persists across restarts. Set QCAD_MCP_DEPOT to use another location. The backend listens on port 11966 and the dashboard uses port 11967. MCP clients connect through the SSE endpoint shown in the repository configuration:

{
  "mcpServers": {
    "qcad": {
      "url": "http://localhost:11966/sse",
      "transport": "sse"
    }
  }
}

Most core operations use the Python ezdxf engine. QCAD Pro is an optional dependency for operations such as DWG conversion, high-fidelity rendering, dimensions, annotations, hatches, block insertion, arrays, wall-data extraction, and ECMAScript execution. The qcad_status tool reports whether QCAD Pro is installed, running, and which version is available. Beam analysis uses NumPy and does not require QCAD Pro.

Tools and capabilities

The qcad-mcp MCP server provides read, mutation, and status tools covering the following workflows:

• List depot files and inspect layers, entities, bounds, and blocks with plan_depot and plan_info.
• Create, modify, measure, export, preview, and analyse DXF plans with plan_create, plan_modify, plan_measure, plan_export, plan_to_svg, and plan_analyse.
• Generate STL meshes from walls with plan_extrude, or produce BIM-oriented wall JSON with plan_wall_data when QCAD Pro is available.
• Add dimensions, text, hatches, blocks, and array patterns through QCAD Pro tools.
• Convert DXF and DWG files, render SVG/PDF/BMP output, and run QCAD ECMAScript using the relevant QCAD Pro tools.
• Search and download CAD blocks from a library described as containing more than 4,800 entries.
• Search and download QCAD ECMAScript scripts from the gallery or Gist.
• Run 2D beam finite-element analysis with plan_beam_analysis.
• Use plan_agentic for natural-language-to-ECMAScript workflows and plan_transpile for AutoLISP-to-QCAD ECMAScript translation; both require QCAD Pro and are MCP-only tools.

The quick-start workflow uses just bootstrap to synchronize Python and frontend dependencies, followed by start.ps1 to start the backend and frontend on Windows.

Limitations and notes

QCAD Pro is required for the tools explicitly marked as QCAD Pro features; the repository does not present those operations as available through ezdxf alone. The REST API and dashboard expose additional server functionality, but MCP clients should use the configured SSE endpoint for MCP tool access. The raster-to-DXF process described in the repository is planned rather than a currently listed MCP tool, so it should not be treated as built-in support.