Lisply MCP

🚀 模型

本项目主要围绕模型相关的容器、连接、权限等方面提供故障排查与解决办法，同时说明了软件的许可证相关信息。

🚀 快速开始

以下将针对不同的问题场景，提供具体的排查和解决步骤。

✨ 主要特性

• 提供容器启动失败、连接错误、权限问题等常见问题的排查步骤。
• 给出了一系列诊断命令，方便进行故障排除。
• 详细说明了软件的许可证及相关影响。

📦 安装指南

文档中未提及安装相关内容，故跳过此章节。

💻 使用示例

容器无法启动

如果 Lisply 容器启动失败，可按以下步骤排查：

1. 检查 Docker 是否正在运行：

docker info

2. 检查端口是否已被占用：

sudo lsof -i :4201
sudo lsof -i :9081

3. 验证 Docker 镜像是否存在：

docker images | grep genworks

4. 尝试手动拉取镜像：

docker pull genworks/gendl:master-ccl

连接错误

如果 LLM Agent / MCP 客户端无法连接到配置的 Lisply 后端，可按以下步骤排查：

1. 检查 Lisply 服务器是否正在运行：

docker ps | grep lisply

2. 启用调试日志记录：

{
  "mcpServers": {
    "lisply": {
      "command": "wsl", 
      "args": [
        "node",
        "/path/to/cloned/lisply-mcp/scripts/mcp-wrapper.js"
      ]
    }
  }
}

3. 检查包装程序的日志文件：

tail -f /tmp/lisply-mcp-wrapper.log

4. 在 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

5. 尝试向 Lisply HTTP 服务器发出 curl 请求：

curl http://localhost:9081/lisply/ping-lisp

6. 尝试连接到 Lisply SWANK 服务器（默认端口 4201）：

M-x slime-connect  ;; from emacs

权限问题

如果遇到权限错误，可按以下步骤排查：

1. 检查 Docker 套接字权限：

ls -l /var/run/docker.sock

2. 确保您的用户有权访问 Docker：

sudo usermod -aG docker $USER

3. 检查挂载目录的权限：

ls -l /path/to/mounted/directory

⚠️ 重要提示

Lisply 后端生成的文件可能属于不同的用户。这可以通过某些 docker exec 命令进行修复，我们希望自动化这些命令，例如在典型设置部分中看到的 mcp/filesystem 服务器示例中传递 -u 参数到 docker run 命令。

诊断命令

使用以下命令进行故障排除：

1. 检查包装程序日志：

tail -f /tmp/lisply-mcp-wrapper.log

2. 检查 Docker 容器日志：

docker logs $(docker ps --filter "name=lisply-mcp" --format "{{.ID}}")

3. 检查 Lisply 服务状态：

curl http://localhost:9081/lisply/ping-lisp

4. 验证 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 文件中找到。