Lilith Shell

🚀 Lilith Shell 中文指南

Lilith Shell 是一款用於增強開發環境的工具，它能提供更強大的命令執行能力，允許用戶通過自然語言與系統交互，執行各類 shell 命令，極大提升開發效率。

🚀 快速開始

Lilith Shell 為開發者帶來了便捷的命令執行體驗，讓你可以用自然語言與系統交互。下面為你詳細介紹使用前的準備工作。

📦 安裝指南

下載代碼庫

你可以從 GitHub 克隆代碼倉庫：

git clone https://github.com/yourusername/lilith-shell.git
cd lilith-shell

安裝依賴項

確保你已經安裝了 Python 3.10 或更高版本，以及 pip。然後運行以下命令安裝所需的包：

pip install -r requirements.txt

📚 詳細文檔

配置指南

Windows 系統配置

創建或編輯位於 %LOCALAPPDATA%\AnthropicClaude\config 目錄中的 lilith_shell_config.json 文件，內容如下：

{
  "mcpServers": {
    "lilith-shell": {
      "command": "C:/path/to/lilith-shell/venv/Scripts/python.exe",
      "args": [
        "C:/path/to/lilith-shell/src/lilith_shell/executor.py"
      ],
      "env": {
        "PYTHONPATH": "C:/path/to/lilith-shell/src"
      }
    }
  }
}

macOS 系統配置

創建或編輯位於 ~/Library/Application Support/Lilith Shell 目錄中的 lilith_shell_config.json 文件，內容如下：

{
  "mcpServers": {
    "lilith-shell": {
      "command": "/path/to/lilith-shell/venv/bin/python",
      "args": [
        "/path/to/lilith-shell/src/lilith_shell/executor.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/lilith-shell/src"
      }
    }
  }
}

安全注意事項

⚠️ 重要提示

• 僅在虛擬機或一次性開發環境中使用。
• 切勿在生產系統或包含敏感數據的設備上使用。
• 建議監控系統的訪問和操作日誌。

故障排除

檢查日誌

• Windows：查看 %APPDATA%\Lilith Shell\Logs\mcp*.log 或 %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log 文件。
• macOS：查看 ~/Library/Logs/Lilith Shell/mcp*.log 文件。

驗證安裝

1. 確保 uv 已正確安裝並添加到 PATH 環境變量中。
2. 檢查 mcp 包是否已安裝：

   pip show mcp
   

3. 確認 Python 版本為 3.10 或更高。

手動測試服務器

進入 Lilith Shell 目錄，運行以下命令啟動服務器：

# 在 macOS 上：
./venv/bin/python src/lilith_shell/executor.py

# 在 Windows 上：
.\venv\Scripts\python.exe src\lilith_shell\executor.py

測試指令示例

在 Claude Desktop 中嘗試以下指令：

你能告訴我當前目錄嗎？

或

列出比我 200 MB 大的文件。

注意：本項目基於 Pandoras-Shell 開發，增加了更多安全性和功能性改進。