Model Context Protocol (MCP) Wrapper for Lisply Backends
2025.04.15
6
JavaScriptAI辅助编程符号计算开发效率
Lisply MCP是一个基于Node.js的MCP（Model Context Protocol）包装器，用于连接Claude Desktop等AI客户端与Lisply后端服务（如Gendl）。它提供了一个强大的接口，使AI能够直接进行符号编程，包括Lisp代码评估、HTTP请求、文档查询等功能。该服务支持Docker容器管理，自动启动和停止Gendl容器，并提供了丰富的配置选项和调试工具。
View on GitHub
Overview
基本能力
产品定位
Lisply MCP是一个桥梁工具，旨在连接AI助手（如Claude）与Lisp后端服务，实现AI辅助的符号编程。
核心功能
- Lisp代码评估：在Lisply环境中评估Lisp代码。
- HTTP请求：与Lisply后端实现的HTTP端点交互。
- 文档查询：访问Lisply的文档和内省功能。
- 文件操作：通过Lisp评估创建、操作、编译和加载文件。
- 调试支持：与Lisp调试器交互（适用于本地启动的容器）。
- Docker集成：自动管理Gendl容器，包括启动、停止和配置。
- 多服务支持：支持HTTP、HTTPS、SWANK和TELNET服务。
适用场景
- AI辅助编程：通过Claude等AI助手进行Lisp代码生成和调试。
- 符号计算：利用Gendl的几何原语进行复杂计算。
- 知识库查询：搜索Gendl/GDL的相关信息和文档。
- 远程服务交互：与远程Lisply服务进行HTTP交互。
工具列表
- lisp_eval：评估Lisp代码，支持HTTP和STDIO模式。
- http_request：与Lisply后端的HTTP端点交互。
- query_gendl_kb：查询Gendl知识库。
- ping_gendl：检查Gendl服务器是否可用。
常见问题解答
- 容器无法启动：检查Docker是否运行，端口是否被占用，或手动拉取镜像。
- 连接错误：启用调试日志，检查服务状态，或尝试ping服务。
- 权限问题：确保用户有Docker和挂载目录的权限。
使用教程
使用依赖
- 安装Node.js和npm。
- 确保Docker已安装并运行。
安装教程
- 克隆仓库并安装依赖：
cd /path/to/lispy-mcp/scripts
npm install
chmod +x mcp-wrapper.js
- 测试脚本：
node mcp-wrapper.js --help
调试方式
- 启用调试日志：
node mcp-wrapper.js --debug
- 检查日志文件：
tail -f /tmp/mcp-wrapper.log
- 检查容器日志：
docker logs $(docker ps --filter "name=lispy-mcp" --format "{{.ID}}")
- 检查服务状态：
curl http://localhost:10080/mcp/ping-gendl