Lisply MCP

🚀 モデル

このプロジェクトは、Lisply コンテナや関連するサーバーのセットアップとトラブルシューティングに関する情報を提供します。また、ソフトウェアのライセンスについても説明しています。

🚀 クイックスタート

このセクションでは、Lisply コンテナや関連するサーバーのトラブルシューティング方法について説明します。

コンテナが起動しない場合

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 サーバーの例では、docker run コマンドに -u パラメーターを渡すことができます。

診断コマンド

以下のコマンドを使用してトラブルシューティングを行います。

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 ファイルに記載されています。