lisp-mcp

An MCP (Model Context Protocol) server that gives LLMs the ability to evaluate Common Lisp expressions. It provides up to three tools depending on configuration:

eval_host_cl -- always available; evaluates expressions in the MCP server's own SBCL process
eval_swank -- connects to a running Lisp via the Swank protocol (the backend used by SLIME and Sly)
eval_genera -- bridges to a Symbolics Genera machine over TCP

Prerequisites

SBCL on the host machine
Quicklisp installed in SBCL (the MCP server loads usocket and yason via Quicklisp)

MCP configuration

Add the following to your .mcp.json (or the MCP configuration of your client):

{
    "mcpServers": {
        "lisp": {
            "command": "/path/to/lisp-mcp.sh",
            "env": {
                "SWANK_PORT": "4005",
                "GENERA_HOST": "192.168.11.2"
            }
        }
    }
}

Only command is required. The environment variables enable the optional tools.

Tools

eval_host_cl

Evaluate a Common Lisp expression in the MCP server's own SBCL process. Always available, no configuration needed. Stdout, stderr, and the return value are captured and returned.

eval_swank

Evaluate a Common Lisp expression on a running Lisp that has a Swank server. This is the most useful tool for development -- it lets the LLM interact with your live Lisp image, load systems, inspect state, and run tests.

The Swank client implements the Swank wire protocol, handles debugger entry by automatically invoking the *ABORT restart and returning the error description, and responds to interactive prompts (e.g. y-or-n-p during compilation).

Start a Swank server in your target Lisp:

(swank:create-server :port 4005 :dont-close t)

The :dont-close t argument keeps the server listening after the first connection disconnects, so the MCP server can reconnect between requests.

To have Swank automatically start an additional server on a fixed port whenever you launch SLIME from Emacs with M-x slime, add the following to your Emacs configuration:

(add-hook 'slime-connected-hook
          (lambda ()
            (slime-eval-async '(swank:create-server :port 4005 :dont-close t))))

Then set SWANK_PORT in the MCP configuration to enable the tool.

Variable	Default	Description
`SWANK_PORT`	(unset)	TCP port of the Swank server. When set, enables `eval_swank`.
`SWANK_HOST`	`127.0.0.1`	Hostname or IP of the Swank server
`SWANK_PACKAGE`	`COMMON-LISP-USER`	Package in which expressions are evaluated

eval_genera

Evaluate a Lisp expression on a Symbolics Genera machine. Requires eval-server.lisp running on the Genera side.

Set GENERA_HOST in the MCP configuration to enable the tool.

Variable	Default	Description
`GENERA_HOST`	(unset)	Hostname or IP of the Genera machine. When set, enables `eval_genera`.
`GENERA_PORT`	`8888`	TCP port of the eval server
`GENERA_TIMEOUT`	`300`	Timeout in seconds for each evaluation

Setting up the Genera side

Copy eval-server.lisp to the Genera SYS:SITE; directory on the host filesystem:

cp eval-server.lisp /opt/symbolics/lib/sys.sct/site/eval-server.lisp

Then load it from the Genera Lisp Listener:

Load File SYS:SITE;eval-server.lisp

The file must be loaded once per boot. It defines a TCP server (:mcp-server) on port 8888 that accepts connections, reads length-prefixed Lisp expressions, evaluates them, and returns the result, stdout, and stderr as length-prefixed fields.

To verify it is running:

echo -n '11 (+ 1 2 3 4)' | nc -w 2 192.168.11.2 8888 | cat -v

symbolics-mcp