mcp-server-autocad-lisp-helper

README.md

<!-- mcp-name: io.github.radwanalmsora/mcp-server-autocad-lisp-helper -->
mcp-name: io.github.radwanalmsora/mcp-server-autocad-lisp-helper

# 📐 AutoCAD AutoLISP Helper MCP Server

<div align="center">

[![PyPI - Version](https://img.shields.io/pypi/v/mcp-server-autocad-lisp-helper?style=for-the-badge&logo=pypi&logoColor=white&color=0073e6)](https://pypi.org/project/mcp-server-autocad-lisp-helper/)
[![Python Version](https://img.shields.io/pypi/pyversions/mcp-server-autocad-lisp-helper?style=for-the-badge&logo=python&logoColor=white)](https://pypi.org/project/mcp-server-autocad-lisp-helper/)
[![License: MIT](https://img.shields.io/badge/License-MIT-F5A623?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)
[![MCP Compliant](https://img.shields.io/badge/MCP-Standard-10b981?style=for-the-badge&logo=anthropic&logoColor=white)](https://modelcontextprotocol.io)

**A high-precision, deterministic [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server engineered in Python to statically inspect, parse, and debug AutoCAD AutoLISP (`.lsp`) files with 100% precision.**

[Quickstart](#-quickstart-zero-install) • [Tools Overview](#-exposed-mcp-tools) • [Claude Desktop Setup](#-claude-desktop-integration) • [Architecture](#-architecture--deterministic-parsing)

</div>

---

## 🌟 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

| Tool | Purpose | Key Capabilities |
| :--- | :--- | :--- |
| **`analyze_lisp_syntax`** | Structural Syntax Audit | Validates balanced parentheses `( )`, quotes `"..."`, and block comments `;\| ... \|;`. Reports exact line and column offsets for syntax errors. |
| **`extract_lisp_functions`** | AST Function Inspection | Extracts all `(defun ...)` and AutoCAD commands `(defun c:... ...)`. Accurately isolates arguments and localized variables declared after the `/`. |
| **`check_missing_cleanups`** | State Leakage Detection | Identifies 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`**:

```bash
uvx mcp-server-autocad-lisp-helper

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.7/5.0

Scored 2026-11-07 02:20 across 3 tools

Disambiguation5/5

Each tool targets a clearly distinct analysis concern: structural syntax validation, function/variable extraction, and cleanup/state-leakage checking. Although all three operate on AutoLISP source statically, the descriptions draw sharp boundaries so an agent can select correctly with no overlap.

Naming Consistency5/5

All three names follow a strict verb_noun snake_case pattern (analyze_..., extract_..., check_...). The convention is uniform and self-describing, with no mixed casing or verb styles.

Tool Count4/5

Three focused tools is at the low end of the typical 3-15 range but each earns its place for a narrow lint-style helper. It is not bloated, though the surface feels slightly thin for a full AutoLISP assistance workflow.

Completeness4/5

The set covers the core static-analysis lifecycle for AutoLISP: syntax validation, symbol/function extraction, and cleanup-state auditing. Minor gaps exist around remediation (auto-fix/format) or deeper cross-reference/usage analysis, but agents can work around these.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

TDQS

Maintenance

Resources