AutoCAD LT AutoLISP MCP Server

# AutoCAD LT AutoLISP MCP Server This MCP server enables natural language control of AutoCAD LT 2024/2025 through AutoLISP code generation and execution. It bridges Claude or other LLM clients with AutoCAD LT for creating engineering drawings, P&ID diagrams, and technical documentation through conversational prompts. ## 🚀 Key Features ### Core Drawing Operations - Generates and executes AutoLISP code in AutoCAD LT 2024+ - Creates basic shapes (lines, circles, polylines, text) - Handles block insertion with comprehensive attribute management - Supports advanced geometry (arcs, ellipses, rectangles) - Provides robust layer creation and management - Creates hatches and dimensions for technical drawings ### P&ID and Process Engineering (NEW) - **CTO Library Integration**: Complete access to CAD Tools Online P&ID Symbol Library (600+ ISA 5.1-2009 standard symbols) - **Intelligent Attribute Handling**: Proper block attributes for equipment schedules and valve lists - **Process Equipment**: Pumps, valves, tanks, instruments, and process equipment - **Standard Annotations**: Equipment tags, descriptions, and line numbers - **Layer Management**: Industry-standard P&ID layer organization ### Performance Optimizations - **Fast Mode**: Optimized execution with minimal delays (80% speed improvement) - **Batch Operations**: Create multiple objects in single operations - **Clipboard Integration**: Efficient large script execution - **Smart Loading**: Essential LISP files only for faster startup ## 📋 Prerequisites - **AutoCAD LT 2024 or newer** (with AutoLISP support) - **Python 3.10 or higher** - **Claude Desktop** or other MCP client application - **Optional**: CAD Tools Online P&ID Symbol Library (for full P&ID functionality) ## 🛠️ Setup Instructions ### 1. Install Dependencies ```bash git clone https://github.com/hvkshetry/autocad-mcp.git cd autocad-mcp python -m venv venv venv\Scripts\activate pip install -r requirements.txt ``` ### 2. Configure Claude Desktop **For users WITH CTO Library:** ```json { "mcpServers": { "autocad-mcp": { "command": "path\\to\\autocad-mcp\\venv\\Scripts\\python.exe", "args": ["path\\to\\autocad-mcp\\server_lisp_fast.py"] } } } ``` **For users WITHOUT CTO Library:** ```json { "mcpServers": { "autocad-mcp": { "command": "path\\to\\autocad-mcp\\venv\\Scripts\\python.exe", "args": ["path\\to\\autocad-mcp\\server_lisp.py"] } } } ``` ### 3. CTO Library Setup (Optional but Recommended) **If you have the CAD Tools Online P&ID Library:** 1. Install the CTO library to `C:\PIDv4-CTO\` 2. Verify the following directories exist: - `C:\PIDv4-CTO\VALVES\` - `C:\PIDv4-CTO\EQUIPMENT\` - `C:\PIDv4-CTO\PUMPS-BLOWERS\` - `C:\PIDv4-CTO\TANKS\` - (and other standard categories) **If you DON'T have the CTO Library:** - Use `server_lisp.py` instead of `server_lisp_fast.py` - P&ID tools will not work, but all basic drawing operations remain available - You can still create custom blocks and use standard AutoCAD functionality ### 4. Start AutoCAD and Server 1. **Launch AutoCAD LT** - Create or open a drawing - Ensure command line is visible 2. **Start the Server** ```bash # For users with CTO library (recommended) start_fast_server.bat # For users without CTO library start_lisp_server.bat ``` 3. **Test the Connection** ```bash test_connection.bat ``` ## 🔧 Available Tools ### Basic Drawing Tools - `create_line`: Draw lines between points - `create_circle`: Create circles with center and radius - `create_text`: Add text labels with rotation support - `create_polyline`: Create polylines from point series - `create_rectangle`: Create rectangles from corner points - `batch_create_lines`: Create multiple lines efficiently - `batch_create_circles`: Create multiple circles efficiently - `batch_create_texts`: Create multiple text entities efficiently ### Block and Layer Management - `insert_block`: Insert blocks with attributes and positioning - `set_layer_properties`: Create/modify layers with full properties - `move_last_entity`: Move recently created entities - `update_block_attribute`: Modify block attributes after insertion ### P&ID and Process Tools (CTO Library Required) - `setup_pid_layers`: Create standard P&ID drawing layers - `insert_pid_symbol`: Insert any symbol from CTO library - `insert_pid_equipment_with_attribs`: Insert equipment with proper attributes - `insert_valve_with_attributes`: Insert valves with CTO attributes - `insert_equipment_tag`: Add equipment identification tags - `insert_equipment_description`: Add equipment description blocks - `insert_line_number_tag`: Add process line identification - `draw_process_line`: Draw process piping between points - `connect_equipment`: Connect equipment with orthogonal routing - `add_flow_arrow`: Add directional flow indicators ### Advanced Operations - `create_arc`: Create arcs with center, radius, and angles - `create_ellipse`: Create ellipses with major axis and ratio - `create_mtext`: Add multiline formatted text - `create_linear_dimension`: Add linear dimensions - `create_hatch`: Add hatching to closed areas - `list_pid_symbols`: List available symbols by category ## 📖 Usage Examples ### Basic Drawing ``` "Draw a line from (0,0) to (100,100)" "Create a circle at (50,50) with radius 25" "Add text 'Equipment Room' at position (75,125)" ``` ### P&ID Creation (with CTO Library) ``` "Set up P&ID layers for a new drawing" "Insert a centrifugal pump at (100,100) with tag P-101" "Add a gate valve at (150,100) with size 6 inches and tag V-201" "Connect the pump P-101 to valve V-201 with process piping" "Add equipment tag P-101 above the pump" ``` ### Process Flow Creation ``` "Create a wastewater treatment process with screening, primary clarifier, aeration basin, and secondary clarifier" "Insert a clarifier at (200,100) with equipment number CL-301" "Add line number 8"-WW-001 to the main process line" ``` ### Batch Operations ``` "Create 10 circles in a grid pattern with centers every 50 units" "Draw process lines connecting all equipment in sequence" "Add equipment tags for all pumps with sequential numbering" ``` ## 🚧 Configuration for Users Without CTO Library If you don't have the CAD Tools Online library, you can still use this MCP server effectively: ### 1. Use the Standard Server Replace the server command with: ```json "args": ["path\\to\\autocad-mcp\\server_lisp.py"] ``` ### 2. Modify P&ID Tool Calls The following tools will not work without CTO library: - `insert_pid_symbol` - `insert_pid_equipment_with_attribs` - `insert_valve_with_attributes` - `list_pid_symbols` ### 3. Alternative Approaches Instead of CTO symbols, you can: - Use standard AutoCAD blocks - Create simple geometric representations - Use text labels for equipment identification - Import your own symbol library ### 4. Example Alternative Usage ``` "Draw a circle to represent a pump at (100,100)" "Add text 'P-101 Centrifugal Pump' next to it" "Create a rectangle for a tank at (200,100)" "Connect them with a line for piping" ``` ## 📁 LISP Library Structure The server loads these LISP files for functionality: | File | Purpose | Dependencies | |------|---------|--------------| | `error_handling.lsp` | Base error handling and validation | None (load first) | | `basic_shapes.lsp` | Core drawing functions | error_handling.lsp | | `batch_operations.lsp` | Batch creation tools | basic_shapes.lsp | | `drafting_helpers.lsp` | Block and layer management | basic_shapes.lsp | | `pid_tools.lsp` | P&ID specific operations | drafting_helpers.lsp | | `attribute_tools.lsp` | Block attribute handling | pid_tools.lsp | | `advanced_geometry.lsp` | Extended geometry creation | basic_shapes.lsp | | `advanced_entities.lsp` | Complex entity creation | advanced_geometry.lsp | | `annotation_helpers.lsp` | Text and dimension tools | basic_shapes.lsp | | `entity_modification.lsp` | Entity manipulation | drafting_helpers.lsp | ## ⚡ Performance Optimization ### Fast Mode Benefits - **80% faster** drawing operations using batch tools - **90% faster** server initialization with essential files only - **Clipboard-based** script execution for complex operations ### Batch Operation Examples ```python # Instead of 10 separate create_line calls (8 seconds) batch_create_lines([ [0, 0, 100, 0], [100, 0, 100, 100], [100, 100, 0, 100], # ... more lines ]) # Single call (0.8 seconds) ``` ### Performance Settings Adjust performance based on your system: ```python # Fast systems set_performance_mode(fast_mode=True, minimal_delay=0.03) # Slower systems (more reliable) set_performance_mode(fast_mode=False, minimal_delay=0.1) ``` ## 🔍 Troubleshooting Common issues and solutions: ### LISP Loading Issues - **Problem**: "LOAD failed" errors - **Solution**: Add LISP directory to AutoCAD trusted paths - **See**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md#1-lisp-files-fail-to-load) ### CTO Library Issues - **Problem**: "File not found" for P&ID symbols - **Solution**: Verify CTO installation path or use standard server - **Alternative**: Use `server_lisp.py` without P&ID functionality ### Window Focus Problems - **Problem**: Commands not reaching AutoCAD - **Solution**: Ensure AutoCAD is active, run as Administrator - **See**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md#window-focus-issues) ## 📊 What's New in This Version ### Version 2.0 Features - ✅ **Complete CTO Library Integration** (600+ P&ID symbols) - ✅ **Intelligent Block Attributes** for equipment schedules - ✅ **Fast Mode Server** with 80% performance improvement - ✅ **Batch Operations** for multiple object creation - ✅ **Process Engineering Tools** for P&ID creation - ✅ **Industry Standard Layers** for professional drawings - ✅ **Enhanced Error Handling** and troubleshooting guides ### Migration from v1.0 Users of the original version should: 1. Update to `server_lisp_fast.py` for better performance 2. Add CTO library path if available 3. Review new P&ID tools for process drawings 4. Update Claude Desktop configuration ## 📄 License MIT License - See LICENSE file for details ## 🤝 Contributing Contributions are welcome! Please: 1. Fork the repository 2. Create a feature branch 3. Test with both CTO and non-CTO configurations 4. Submit a pull request with clear documentation ## 📞 Support - **Issues**: [GitHub Issues](https://github.com/hvkshetry/autocad-mcp/issues) - **Documentation**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - **Performance**: [PERFORMANCE_OPTIMIZATION.md](PERFORMANCE_OPTIMIZATION.md) --- *For detailed troubleshooting and advanced configuration, see the additional documentation files in this repository.*