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 文件中找到。