Lisply
Model Context Protocol (MCP) server to manage and talk to compliant 'Lisply' lisp-speaking backend services
What is Lisply?
Lisply is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server to manage and talk to compliant 'lisply' lisp-speaking backend services
Model Context Protocol (MCP) server to manage and talk to compliant 'Lisply' lisp-speaking backend services
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Model Context Protocol (MCP) server to manage and talk to co
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx lisplyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Lisply
Lisply MCP is a Node.js-based MCP server that connects AI agents to Lisply-compliant Common Lisp backend services, enabling them to evaluate Lisp expressions, make HTTP requests, and interact with a live Lisp REPL running inside a Docker container. It supports both Clozure Common Lisp (CCL) and SBCL, auto-starts the appropriate Docker container on demand, and exposes tools for Lisp evaluation and HTTP interaction with the backend. Lisp developers and researchers who want Claude to write, run, and debug Common Lisp code in a live environment will find this server essential.
Prerequisites
- Node.js 18+ (Windows or WSL compatible)
- Docker 20+ running on the same host as Node.js
- Git (to clone the repository)
- Claude Desktop or another MCP-compatible client
- Basic familiarity with Common Lisp (CCL or SBCL)
Clone the repository
Clone the lisply-mcp repository to your local machine.
git clone https://github.com/gornskew/lisply-mcp.git
cd lisply-mcpInstall dependencies
Install the Node.js dependencies for the MCP wrapper script.
cd scripts
npm install
chmod +x mcp-wrapper.jsVerify the wrapper
Run the wrapper with --help to confirm it is set up correctly and to see available command-line arguments.
node mcp-wrapper.js --helpConfigure Claude Desktop
Add the lisply-mcp server to your claude_desktop_config.json. Specify the server name, HTTP port, and Lisp implementation. The wrapper will auto-start the Docker container.
{
"mcpServers": {
"gendl-ccl": {
"command": "node",
"args": [
"/path/to/lisply-mcp/scripts/mcp-wrapper.js",
"--server-name", "gendl-ccl",
"--http-port", "9080",
"--lisp-impl", "ccl"
]
}
}
}Mount host directories (optional)
Use --mount flags to share local project directories with the Lisp container so the agent can load and evaluate files from your file system.
"args": [
"/path/to/lisply-mcp/scripts/mcp-wrapper.js",
"--server-name", "gendl-ccl",
"--mount", "/home/user/projects:/projects",
"--mount", "/home/user/data:/data"
]Test the connection
Restart Claude Desktop and ask it to evaluate a simple Lisp expression to verify the server is working.
Lisply Examples
Client configuration
Register lisply-mcp in Claude Desktop, pointing to the mcp-wrapper.js script with a specific Lisp implementation and HTTP port.
{
"mcpServers": {
"gendl-ccl": {
"command": "node",
"args": [
"/home/user/lisply-mcp/scripts/mcp-wrapper.js",
"--server-name", "gendl-ccl",
"--http-port", "9080",
"--lisp-impl", "ccl",
"--debug"
]
}
}
}Prompts to try
Use Claude to evaluate Lisp code and interact with the live Lisply backend.
- "Evaluate (+ 1 2 3) using the gendl-ccl__lisp_eval tool"
- "Define a Lisp function that computes the Fibonacci sequence and test it with n=10"
- "Check if the Lisply server is running with a ping"
- "Load and evaluate the file at /projects/my-lisp-file.lisp"
- "Make a GET request to /api/status on the Lisply backend"Troubleshooting Lisply
Docker container does not start automatically when Claude Desktop launches
Ensure Docker Desktop is running before launching Claude Desktop. Check that the --docker-image argument or LISPLY_DOCKER_IMAGE env var points to a valid image. Run docker pull on the image manually if needed.
Lisp evaluation times out or hangs
Increase the timeout by setting LISPLY_EVAL_TIMEOUT (in milliseconds) in the environment or via config. The default is 30000ms. Long-running computations may need a higher value.
Permission denied on mcp-wrapper.js on Linux/macOS
Run chmod +x /path/to/lisply-mcp/scripts/mcp-wrapper.js. Also ensure the Node.js binary is in the PATH that Claude Desktop uses.
Frequently Asked Questions about Lisply
What is Lisply?
Lisply is a Model Context Protocol (MCP) server that model context protocol (mcp) server to manage and talk to compliant 'lisply' lisp-speaking backend services It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Lisply?
Follow the installation instructions on the Lisply GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Lisply?
Lisply works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Lisply free to use?
Yes, Lisply is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Lisply Alternatives — Similar Developer Tools Servers
Looking for alternatives to Lisply? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Lisply in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Lisply?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.