Lilith Shell

🚀 Lilith Shell 中文指南

Lilith Shell 是一款用于增强开发环境的工具，它能赋予用户更强大的命令执行能力。借助该工具，用户可通过自然语言与系统交互，轻松执行各类 shell 命令。

🚀 快速开始

Lilith Shell 能极大提升开发环境的命令执行能力，让你通过自然语言与系统交互，方便快捷地执行 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 开发，增加了更多安全性和功能性改进，你可以参考原项目获取更多信息。