Lisply
Created 5 months ago
Middleware for Lisp-based environments enabling interaction with Large Language Models.
What is Lisply?
Flexible frontend for compliant Lisp-speaking backends.
Documentation
Model Context Protocol (MCP) Middleware for Lisp-based and Lisp-like Environments
This project is a Model Context Protocol (MCP) middleware that enables Large Language Models (LLMs) to interact with Lisp-based development and runtime environments using a lightweight protocol called Lisply.
Who Is this Meant For?
- AI practitioners curious about Lisp
- Lisp practitioners curious about AI
- Anyone interested in Neuro-Symbolic Programming
- Mechanical/Civil Engineers and Designers interested in CAD Automation and Knowledge Based Engineering
- Tinkerers, meddlers, and tamperers from all walks of life
What Is it Meant to Do?
The Lisply-MCP middleware connects MCP-capable AI Agent programs, or MCP Clients, such as ClaudeDesktop, to Lisp-based systems which support a REPL, or Read-Eval-Print Loop. The connection is meant to facilitate AI-assisted symbolic programming sometimes referred to as Neuro-Symbolic Programming. We have coined the term "Lisply" to refer to a lightweight protocol which most any Lisp-like system can implement to render it compatible with this Lisply-MCP middleware. The idea is that the LLM will be able to generate and evaluate arbitrary Lisp expressions, including creating, compiling, loading, and testing entire files and projects.
Extra Quick Start
Follow the "Containerized Runnings" section of the skewed-emacs README. This will get you a Docker Compose setup including a preconfigured containerized version of Lisply-MCP.
Quick Start
The following will get you up and running quickly with a minimal default configuration and a default public Common Lisp based backend running as a Docker container. See the main Contents below for more background and detailed configuration options.
1. Install
- Install Node.js (18+ recommended). If on Windows, this can be installed directly in Windows or in WSL.
- Install Docker (20+ recommended) on the same host as where the Node.js is installed.
- Clone this
lisply-mcprepository to a location where your MCP-capable AI Agent (e.g. Claude Desktop) can access it.
2. Configure your MCP-capabile AI Agent
Edit or create your AI Agent's configuration file as shown below. In the case of Claude Desktop, the configuration file is typically:
{ "mcpServers": { "lisply-gendl": { "command": "node", "args": [ "/path/to/cloned/lisply-mcp/scripts/mcp-wrapper.js", "--server-name", "gendl" ] } } }
3. Restart your AI Agent and Test
With the above configuration in place, your freshly restarted AI Agent will now have access to an MCP server called lisply-gendl, with a gendl__lisp_eval MCP tool (among a few other tools discussed in the main Contents below).
Server Config
{
"mcpServers": {
"lisply-server": {
"command": "npx",
"args": [
"lisply"
]
}
}
}