Transform AutoCAD into an AI-driven design platform with natural language commands
The AutoCAD MCP Server is the first-of-its-kind Model Context Protocol server that connects AutoCAD 2025 directly to AI assistants, enabling natural language CAD automation and intelligent design workflows.
📋 Project Status: Core MCP functionality is production-ready with 7 working AutoCAD tools. Advanced features (25+ components) exist as comprehensive development code and are available for integration and testing. See the Development Codebase Statistics section for detailed information.
✨ Revolutionary AI Integration: Command AutoCAD through natural conversation
🎯 Production Ready: 7 AutoCAD tools working flawlessly with MCP clients
🔬 Research Platform: Extensive development codebase with 25+ advanced features in progress
🔧 Developer Friendly: Works seamlessly with Claude Code CLI in WSL/VS Code
🚀 Instant Results: "Draw a circle at (50,50,0) with radius 25" actually works!
✅ Currently Working & Tested:
- 7 AutoCAD MCP Tools: Create lines, circles, extrusions, revolutions, and more
- AI Assistant Integration: Claude Desktop, Claude Code CLI, Cursor, and other MCP clients
- Live AutoCAD Control: Real-time drawing manipulation through conversation
- WSL/VS Code Support: Perfect integration with Claude Code CLI running in WSL terminal
- Stable COM Interface: Reliable AutoCAD 2025 connectivity via pyautocad
🔬 Research Codebase Includes:
- 25+ Advanced Features: Comprehensive implementations ready for integration
- AI-Powered Tools: Natural language processing, code generation, error prediction
- Enterprise Components: Security monitoring, performance optimization, collaboration
- Interactive Development: Advanced debugging, code refactoring, intelligent autocomplete
- Surface Processing: LSCM unfolding, geodesic calculations, mesh optimization
- AutoCAD 2025 (full version) installed and activated
- Python 3.12+
- Windows OS (required for AutoCAD COM interface)
-
Clone & Install
git clone https://github.com/BarryMcAdams/AutoCAD_MCP.git cd AutoCAD_MCP uv sync # or: poetry install
-
Add to Claude Desktop MCP Configuration
{ "mcpServers": { "autocad-mcp": { "command": "./.venv/Scripts/python.exe", "args": ["src/server.py"], "cwd": "C:\\path\\to\\your\\AutoCAD_MCP" } } } -
Start Creating!
- Launch AutoCAD 2025 with a drawing open
- Open Claude Desktop
- Say: "Check AutoCAD connection and draw a line from origin to (100,100,0)"
Ideal for VS Code + WSL Development Workflow:
-
Setup in WSL Terminal (inside VS Code)
git clone https://github.com/BarryMcAdams/AutoCAD_MCP.git cd AutoCAD_MCP uv sync -
Add MCP Server
claude mcp add autocad-mcp ./.venv/Scripts/python.exe src/server.py
-
Start Coding with AI
# In VS Code terminal (WSL) claude # Then: "Draw a complex 3D building structure with parametric dimensions"
Why Claude Code CLI + WSL?
- ✅ Perfect Development Flow: Code, test, and create in one environment
- ✅ Natural Integration: AutoCAD automation directly in your development workflow
- ✅ Instant Testing: Generate and test AutoCAD scripts without switching contexts
- ✅ Version Control: All your AI-generated CAD automation is tracked in git
Transform these natural language requests into AutoCAD actions:
| Tool | What It Does | Example Command |
|---|---|---|
| draw_line | Creates lines between 3D points | "Draw a line from (0,0,0) to (100,50,25)" |
| draw_circle | Creates circles with center/radius | "Create a circle at origin with radius 50" |
| extrude_profile | Creates 3D solids from 2D profiles | "Extrude this square profile 20 units high" |
| revolve_profile | Creates solids by revolving profiles | "Revolve this arc around the Y-axis 180 degrees" |
| list_entities | Lists all drawing entities | "Show me all objects in the current drawing" |
| get_entity_info | Gets detailed entity information | "Get details for entity ID 12345" |
| server_status | Checks MCP server connection | "Is the AutoCAD MCP server connected?" |
"Draw a complete building floor plan" → Framework for generating walls, doors, windows
"Create a mechanical part with dimensions" → Tools for building 3D models with annotations
"Optimize this surface for manufacturing" → Research algorithms for unfolding 3D surfaces to 2D patterns
"Generate 50 variations of this design" → Development platform for parametric design automation
- Natural Language Processor: Framework for converting plain English to AutoCAD operations
- AI Code Generator: Intelligent AutoLISP and Python code generation system
- Error Prediction Engine: Predictive analysis for issue prevention
- Automated Code Reviewer: Quality assurance framework for generated scripts
- LSCM Surface Unfolding: Mathematical algorithms for converting 3D surfaces to 2D patterns
- Pattern Optimization: Research implementations for material waste reduction
- Geodesic Calculations: Advanced 3D geometry processing libraries
- Performance Optimization: Scalable processing architecture
- Security Monitoring: Comprehensive audit logging framework
- Performance Analytics: Advanced monitoring with anomaly detection capabilities
- Collaboration Architecture: Multi-user real-time design collaboration framework
- Deployment Automation: Docker/Kubernetes deployment templates
"Unfold this aircraft panel for laser cutting"
"Generate nesting patterns to minimize steel waste"
"Create manufacturing drawings with all dimensions"
"Design a building facade with parametric panels"
"Create a spiral staircase with custom dimensions"
"Generate technical drawings for construction"
"Model this mechanical assembly with tolerances"
"Create stress analysis preparation geometry"
"Generate CAM-ready toolpaths for this part"
"Teach me 3D modeling by creating simple shapes"
"Show me how to dimension a technical drawing"
"Create examples for AutoCAD best practices"
✅ Core Infrastructure Validated
- Server starts reliably on Windows/WSL environments
- MCP protocol implementation fully compliant
- AutoCAD COM integration stable across sessions
✅ Production Testing
- Successfully integrated with Claude Desktop and Claude Code CLI
- Handles basic 3D operations through MCP interface
- Development environment tested with multiple Python versions
✅ Development Ecosystem
- Complete Python development environment with Poetry/uv
- Testing framework with pytest infrastructure
- Docker containerization templates for deployment
# Server Configuration
HOST=localhost
PORT=5001
DEBUG=false
# AutoCAD Integration
AUTOCAD_TIMEOUT=30
MAX_BATCH_SIZE=100
# Performance Tuning
DEFAULT_TOLERANCE=0.001
MAX_DISTORTION_THRESHOLD=0.1The server supports extensive customization through src/config.py for enterprise deployments, including performance optimization, security settings, and integration parameters.
# Test MCP server connection
claude mcp list
# Test AutoCAD integration (requires AutoCAD running)
# In Claude: "Check AutoCAD MCP server status"# Run test suite
poetry run pytest
# Test core algorithms
python -c "from src.algorithms.lscm import LSCMSolver; print('✅ LSCM loads successfully')"
# Performance baseline
python src/tools/performance_baseline.py- Issues: Report bugs or request features on GitHub
- Discussions: Share your AutoCAD automation success stories
- Pull Requests: Contribute new MCP tools or algorithm improvements
- Code Quality: Black formatting, Ruff linting, comprehensive type hints
- Testing: Maintain >90% test coverage with both unit and integration tests
- Documentation: Clear docstrings and API documentation for all features
Manufacturing: Pattern optimization algorithms designed to help reduce material waste
Architecture: AI-assisted modeling framework for accelerated design iteration
Education: Natural language instruction system for transforming CAD learning
Engineering: Automation tools aimed at eliminating repetitive drafting tasks
- Getting Started Guide: Complete setup walkthrough in
docs/ - API Reference: Detailed endpoint documentation
- Best Practices: Proven patterns for AutoCAD automation
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: Community Q&A and project showcase
- Developer Documentation: Architecture guides and extension tutorials
MIT License - Build amazing things with AutoCAD MCP Server!
- AutoCAD COM API: Foundation for reliable CAD integration
- Model Context Protocol: Revolutionary AI assistant integration standard
- SciPy & NumPy: Advanced mathematical processing capabilities
- Flask: Robust web framework for enterprise deployments
This project includes a substantial research and development codebase with 25+ advanced features implemented across multiple domains. While not yet integrated into the MCP server, these components represent significant engineering work and provide a foundation for future capabilities.
- AI Code Generator (1,250 lines) - Intelligent AutoLISP, Python, and VBA code generation
- Natural Language Processor (886 lines) - Framework for converting plain English to AutoCAD operations
- Automated Code Reviewer (913 lines) - Quality assurance and best practices enforcement
- API Recommendation Engine (894 lines) - ML-powered API suggestions and usage analytics
- Error Prediction Engine (849 lines) - Predictive analysis for issue prevention
- Performance Optimization (1,916 lines) - Multi-level caching, resource pooling, auto-scaling
- Monitoring Dashboard (1,435 lines) - Advanced analytics with anomaly detection
- Deployment Automation (1,146 lines) - Docker/Kubernetes support and CI/CD pipelines
- Security Monitoring (1,098 lines) - Comprehensive audit logging with tamper-proof integrity
- Collaboration Architecture (870 lines) - Multi-user real-time design collaboration
- Advanced Breakpoints (1,010 lines) - Smart conditional breakpoints with hierarchical groups
- Code Refactoring Engine (997 lines) - AST-based analysis and transformation
- Variable Inspector (986 lines) - Multi-level introspection with AutoCAD object specialization
- Intelligent AutoComplete (920 lines) - ML-powered IntelliSense with context awareness
- Performance Analyzer (788 lines) - Comprehensive performance profiling and optimization
- Error Diagnostics (771 lines) - Advanced error detection and resolution suggestions
- Debugger (649 lines) - Interactive debugging with AutoCAD integration
- Python REPL (443 lines) - Interactive Python environment for AutoCAD
- Session Manager (494 lines) - Development session persistence and recovery
- Security Sandbox (425 lines) - Safe code execution environment
- Execution Engine (396 lines) - Code execution with monitoring and control
- Secure Evaluator (312 lines) - Safe evaluation of user-provided code
- VBA Generator (1,048 lines) - AutoCAD VBA macro generation with best practices
- Python Generator (1,020 lines) - Python script generation for AutoCAD automation
- Template Manager (981 lines) - Dynamic template system for code generation
- Validation Engine (758 lines) - Code validation and quality assurance
- AutoLISP Generator (699 lines) - AutoLISP routine generation and optimization
- Language Coordinator (448 lines) - Multi-language code generation orchestration
- Mesh Utilities (370 lines) - Advanced mesh processing and manipulation
- Geodesic Calculations (361 lines) - Geodesic distance and path calculations
- LSCM Surface Unfolding (334 lines) - Least Squares Conformal Maps for surface flattening
- Pattern Optimization (Additional algorithms for material waste reduction)
- 25,518+ lines of research and development code
- 25+ major components with comprehensive implementations
- Enterprise-grade architecture with security, monitoring, and scalability
- Machine Learning Integration with graceful fallbacks when ML libraries unavailable
- Comprehensive Testing Framework with unit and integration test infrastructure
These features represent active research and development work, with comprehensive implementations ready for:
- Integration testing and validation
- Performance optimization and benchmarking
- User interface development and integration
- Production deployment and scaling
The substantial codebase demonstrates the project's commitment to building a comprehensive AutoCAD automation platform with enterprise-grade capabilities.
✅ Core Features Ready: AutoCAD MCP Server provides working MCP integration
✅ Actively Developed: Regular updates and extensive research codebase
✅ Research Platform: Comprehensive development foundation for advanced features
Ready to explore AI-powered AutoCAD automation? Get started with the core MCP tools in 3 minutes!
AutoCAD MCP Server - Where AI Meets CAD Excellence 🚀