cl-MCP
A Model Context Protocol server for Common Lisp enabling AI agents to interact with Lisp environments via REPL, file operations, and code editing tools.
Overview
cl-mcp is a Model Context Protocol (MCP) server implementation for Common Lisp, providing JSON-RPC 2.0 communication over stdio, TCP, and HTTP transports. It bridges AI agents like Claude Code with Common Lisp development environments, offering structured tools for interactive programming, system management, and code manipulation.
Key Features
- REPL Evaluation with Inspection — Execute Lisp forms and drill down into complex results like CLOS instances and hash-tables with structured error context.
- Sandboxed File Operations — Read, write, and list files restricted to project root and ASDF system directories to prevent accidental external access.
- Structure-Aware Lisp Editing — Replace, insert, and patch top-level forms using Eclector CST parsing with automatic parinfer repair, preserving formatting and comments.
- Code Intelligence — Symbol lookup, metadata, and cross-references via
sb-introspect, with Lisp-aware file viewing and pattern-based expansion. - Structured Test Runner — Execute Rove tests with pass/fail counts, failure details, and source locations.
- Worker Pool Isolation — Run eval-dependent tools in isolated child SBCL processes with crash recovery, circuit breaker, and per-session affinity.
- Multiple Transport Support — Support for stdio, TCP (multi-client), and Streamable HTTP (for Claude Code integration).
Philosophy
cl-mcp is designed as a trusted, localhost-only development tool that prioritizes safety through sandboxing and isolation while enabling powerful AI-assisted Common Lisp workflows.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.