Repository avatar
Other Tools
v0.1.1
active

mcp-server-autocad-lisp-helper

io.github.radwanalmsora/mcp-server-autocad-lisp-helper

High-precision static analysis and debug server for AutoCAD AutoLISP (.lsp) files.

Documentation

📐 AutoCAD AutoLISP Helper MCP Server

PyPI - Version Python Version License: MIT MCP Compliant

A high-precision, deterministic Model Context Protocol (MCP) server engineered in Python to statically inspect, parse, and debug AutoCAD AutoLISP (.lsp) files with 100% precision.

Quickstart • Tools Overview • Claude Desktop Setup • Architecture


🌟 Highlights

  • 🔒 Zero Cloud Dependencies: 100% local, fast, and deterministic AST parsing with regex. No external APIs or telemetry.
  • 🎯 Pinpoint Accuracy: Flags balanced parenthesis mismatches with exact line and column numbers.
  • 🛡️ AutoCAD State Protection: Prevents global namespace contamination by detecting unlocalized setq variables.
  • ⚙️ System Variable Auditing: Detects AutoCAD system variable mutations (setvar) lacking initial preservation (getvar).
  • ⚡ Zero-Install Ready: Run instantly in any MCP client via uvx.

🛠️ Exposed MCP Tools

ToolPurposeKey Capabilities
analyze_lisp_syntaxStructural Syntax AuditValidates balanced parentheses ( ), quotes "...", and block comments ;| ... |;. Reports exact line and column offsets for syntax errors.
extract_lisp_functionsAST Function InspectionExtracts all (defun ...) and AutoCAD commands (defun c:... ...). Accurately isolates arguments and localized variables declared after the /.
check_missing_cleanupsState Leakage DetectionIdentifies global variable pollution caused by unlocalized setq assignments and flags unpreserved AutoCAD system variables (setvar).

⚡ Quickstart (Zero-Install)

No manual clone or installation required. Launch directly using uvx:

uvx mcp-server-autocad-lisp-helper
PYPI
mcp-autocad-lisp-helper
Install Command
pip install mcp-autocad-lisp-helper