模型
Model
容器无法启动
如果 Lisply 容器启动失败：
- 检查 Docker 是否正在运行：
docker info
- 检查端口是否已被占用：
sudo lsof -i :4201
sudo lsof -i :9081
- 验证 Docker 镜像是否存在：
docker images | grep genworks
- 尝试手动拉取镜像：
docker pull genworks/gendl:master-ccl
连接错误
如果 LLM Agent / MCP 客户端无法连接到配置的 Lisply 后端：
- 检查 Lisply 服务器是否正在运行：
docker ps | grep lisply
- 启用调试日志记录：
{
"mcpServers": {
"lisply": {
"command": "wsl",
"args": [
"node",
"/path/to/cloned/lisply-mcp/scripts/mcp-wrapper.js"
]
}
}
}
- 检查包装程序的日志文件：
tail -f /tmp/lisply-mcp-wrapper.log
- 在 Windows 上检查 Claude 桌面日志文件，通常路径如下：
WSL/Linux:
/mnt/c/Users/<user>/AppData/Roaming/Claude/logs/mcp-server-lisply.log
Windows:
c:\Users\<user>\AppData\Roaming\Claude\logs\mcp-server-lisply.log
- 尝试向 Lisply HTTP 服务器发出 curl 请求：
curl http://localhost:9081/lisply/ping-lisp
- 尝试连接到 Lisply SWANK 服务器（默认端口 4201）：
M-x slime-connect ;; from emacs
权限问题
如果遇到权限错误：
- 检查 Docker 套接字权限：
ls -l /var/run/docker.sock
- 确保您的用户有权访问 Docker：
sudo usermod -aG docker $USER
- 检查挂载目录的权限：
ls -l /path/to/mounted/directory
注意：Lisply 后端生成的文件可能属于不同的用户。这可以通过某些 docker exec 命令进行修复，我们希望自动化这些命令，例如在典型设置部分中看到的 mcp/filesystem 服务器示例中传递 -u 参数到 docker run 命令。
诊断命令
使用以下命令进行故障排除：
- 检查包装程序日志：
tail -f /tmp/lisply-mcp-wrapper.log
- 检查 Docker 容器日志：
docker logs $(docker ps --filter "name=lisply-mcp" --format "{{.ID}}")
- 检查 Lisply 服务状态：
curl http://localhost:9081/lisply/ping-lisp
- 验证 Docker 环境：
docker system info
许可证
此软件根据 GNU Affero 公共许可证第 3.0 版（AGPL-3.0）发布，与 Gendl 使用相同的许可证。
许可证影响
重要说明：仅使用此 MCP 服务器与 Gendl 交互并获得输出，并不触发 AGPL 的要求。您可以在此包装程序与 Gendl 交互而不必共享您的代码。
然而，如果您修改了此包装程序或符合许可的后端（例如 Gendl），并且基于这些修改分发和/或托管服务，则根据 AGPL 需要您将修改与接收方共享。当然，如果您有任何疑问，请咨询法律顾问。
对于需要保持源代码闭源的应用程序，Genworks 提供了从 AGPL 限制中解脱的发布方式，需支付 5% 的自报告季度收入版税。有关详细信息和一个支付网关将在 payments.genworks.com（即将推出）上提供。
完整的许可证文本可在本目录中的 COPYING.txt 文件中找到。
