Skip to main content
Glama
AutoCAD MCP Server

AutoCAD MCP Server

AutoCAD MCP Server

A comprehensive Flask-based MCP (Model Context Protocol) server that connects to AutoCAD and executes AutoLISP code to facilitate architectural floor plan creation. This server provides a complete suite of tools for efficient creation, modification, and management of architectural drawings through programmatic interfaces.

Features

  • Flask-based REST API server with AutoCAD integration

  • AutoLISP code generation for architectural functions

  • Comprehensive architectural tools for floor planning

  • Real-time AutoCAD communication via COM/ActiveX interface

  • Building code compliance checking

  • Parametric component creation

  • Multi-format export capabilities

  • Template-based drawing setup

Related MCP server: AutoCAD MCP Server

System Requirements

  • Windows 10/11 (required for AutoCAD COM interface)

  • AutoCAD LT 2022 or newer

  • Python 3.8+

  • Required Python packages (see requirements.txt)

Installation

  1. Clone the repository:

git clone https://github.com/GaneshHayagrivanM/onyx-CAD-MCP.git
cd onyx-CAD-MCP
  1. Install Python dependencies:

pip install -r requirements.txt
  1. Ensure AutoCAD is installed and accessible on your system

  2. Configure the server settings in config/settings.py if needed

Quick Start

  1. Start the AutoCAD MCP Server:

python server/app.py
  1. The server will start on http://localhost:5000 by default

  2. Connect to AutoCAD:

curl -X POST http://localhost:5000/api/autocad/connect \
  -H "Content-Type: application/json" \
  -d '{"instance_id": "default"}'
  1. Create your first wall:

curl -X POST http://localhost:5000/api/drawing/wall \
  -H "Content-Type: application/json" \
  -d '{
    "start_point": {"x": 0, "y": 0, "z": 0},
    "end_point": {"x": 120, "y": 0, "z": 0},
    "thickness": 6,
    "height": 96
  }'

Core Functions

Drawing Elements

  • create_wall - Create walls with specified dimensions

  • insert_door - Add doors to walls with swing directions

  • insert_window - Add windows with sill heights

  • create_room - Define room boundaries with area calculation

Layout & Organization

  • setup_grid - Create drawing grid with labels

  • create_layer - Manage drawing layers with properties

  • set_drawing_scale - Set drawing scale

  • setup_viewport - Create viewports

Annotation & Dimensions

  • add_text_note - Add text annotations

  • dimension_linear - Add linear dimensions

  • add_room_label - Label rooms with area

Furniture & Fixtures

  • insert_furniture - Place furniture with rotation and scale

  • create_cabinet - Create cabinet units

  • create_fixture - Add architectural fixtures

Utilities

  • calculate_area - Calculate polygon areas

  • generate_room_schedule - Create room schedules

  • check_building_code - Validate building codes

  • export_to_format - Export drawings (PDF, DXF, DWG)

Advanced Features

  • create_parametric_component - Create parametric objects

  • load_template - Load drawing templates

  • generate_3d_model - Generate 3D models from 2D plans

  • create_section - Create section views

API Documentation

See API.md for complete API documentation with examples.

User Guide

See USER_GUIDE.md for detailed usage instructions.

Configuration

Edit config/settings.py to customize:

  • Server host and port

  • AutoCAD connection settings

  • Default drawing parameters

  • Building code requirements

  • Logging configuration

Testing

Run the test suite:

python -m pytest tests/

Architecture

onyx-CAD-MCP/
├── server/
│   ├── app.py                 # Main Flask application
│   ├── autocad_interface.py   # AutoCAD COM interface
│   ├── lisp_generator.py      # AutoLISP code generation
│   ├── models.py              # Data models
│   └── utils.py               # Utility functions
├── lisp/
│   ├── core_functions.lsp     # Core AutoLISP functions
│   ├── architectural_tools.lsp # Architectural functions
│   └── utilities.lsp          # Utility functions
├── config/
│   └── settings.py            # Configuration
├── tests/
│   └── test_functions.py      # Test suite
├── docs/
│   ├── API.md                 # API documentation
│   └── USER_GUIDE.md          # User guide
├── requirements.txt
└── README.md

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Add tests for new functionality

  4. Ensure all tests pass

  5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues and questions:

  • Create an issue on GitHub

  • Check the documentation in /docs

  • Review the test files for usage examples

Changelog

Version 1.0.0

  • Initial release

  • Complete AutoCAD MCP server implementation

  • All core architectural functions

  • REST API with comprehensive error handling

  • AutoLISP code generation engine

  • Building code compliance checking

  • Template system for different project types

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that bridges Claude with AutoCAD, enabling to generate architectural floor plans, draw geometry, and export DXF files just by describing what you need in natural language.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables natural-language control of AutoCAD via file IPC or headless DXF generation, with tools for drawing, entities, layers, blocks, annotations, P&ID, views, and system operations.
      8
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server that lets AI draw in AutoLISP-capable CAD (reference BricsCAD on Linux) via a file bridge, enabling 2D drafting, 3D solid modeling, and verification with 100 tools.
      128
      3
      Apache 2.0