莉莉丝壳

⚠️重要安全警告：此 MCP 服务器授予 AI 助手在您的系统上无限制执行终端命令的权限。请仅在受控环境（例如虚拟机 (VM) 或您可承受重建的开发系统）中使用。

关于

Lilith Shell 是一款增强型 MCP 服务器，它通过改进的安全控制和测试，使 AI 助手能够在您的系统上执行终端命令。由于其提供不受限制的访问权限，因此务必以负责任的态度使用此软件，并充分了解其相关的安全风险。

注意：此服务器与任何支持模型上下文协议 (MCP) 的 AI 助手兼容。提供的配置和设置说明专为 Claude Desktop 量身定制，全面支持所有 MCP 功能。

Related MCP server: MCP Terminal

特征

• 执行带有安全验证的 shell 命令

• 捕获命令输出（stdout/stderr）

• 设置工作目录

• 处理命令超时

• 提高测试覆盖率

• 增强的安全控制

• FastMCP 集成

API

工具

• 执行命令

  • 执行 shell 命令并返回其输出

  • 输入：

    • command （字符串）：要执行的命令

    • directory （字符串，可选）：工作目录

  • 返回：

    • 命令退出代码

    • 标准输出

    • 标准误差

  • 特征：

    • 5分钟暂停

    • 工作目录支持

    • 错误处理

    • 安全验证

安装

先决条件

• 拥有有效 Claude Pro/Enterprise 订阅的Claude Desktop

  • 下载自： Claude AI

• Python 3.10或更高版本

• Git

• uv （包管理所需）

Windows 安装

1. 安装先决条件：

   选项 A - 使用 winget（如果您的系统上可用）：

   winget install python git

   选项 B - 手动安装（推荐）：

   • 从python.org下载并安装 Python

   • 从git-scm.com下载并安装 Git

2. 安装 uv：

   以管理员身份打开命令提示符（ cmd.exe ）并运行：

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

   如果您遇到任何问题，您可能需要重新启动终端或计算机才能使更改生效。

3. 克隆并设置项目：

   git clone https://github.com/charles-adedotun/Lilith-Shell.git
   cd Lilith-Shell

   然后创建一个虚拟环境。依次尝试以下命令，直到其中一个命令可用：

   python -m venv venv

   如果这不起作用，请尝试：

   python3 -m venv venv

   然后激活环境：

   venv\Scripts\activate

4. 安装依赖项：

   uv pip install -e ".[dev]"

注意：如果您从python.org安装了 Python，通常会使用python 。如果您通过 winget 或 Microsoft Store 安装，则可能需要使用python3 。如果其中一个命令不起作用，请尝试两个命令。

macOS 安装

1. 安装先决条件：

   brew install python git uv

2. 克隆并设置项目：

   git clone https://github.com/charles-adedotun/Lilith-Shell.git
   cd Lilith-Shell
   python3 -m venv venv
   source venv/bin/activate

3. 安装依赖项：

   uv pip install -e ".[dev]"

配置

视窗

找到正确的配置目录 - 按顺序尝试以下路径：

1. %APPDATA%\Claude\ （通常为C:\Users\[YourUsername]\AppData\Roaming\Claude\ ）

2. %LOCALAPPDATA%\AnthropicClaude\ （通常为C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ ）

在正确的目录中创建或编辑claude_desktop_config.json ：

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

Windows 重要说明：

• 在路径中使用正斜杠 ( / )，而不是反斜杠 ( \ )

• 将[YourUsername]替换为您的实际 Windows 用户名

• 文件必须精确命名为claude_desktop_config.json

• 如果两个可能的配置位置都存在，则尝试每个位置直到成功

macOS

创建或编辑~/Library/Application Support/Claude/claude_desktop_config.json ：

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

macOS 重要说明：

• 将[YourUsername]替换为您的实际用户名

• 如果愿意，您可以使用$HOME代替/Users/[YourUsername]

• 文件必须精确命名为claude_desktop_config.json

• command路径应该指向虚拟环境（ venv/bin/python ）内的 Python 解释器，而不是系统 Python

配置后

1. 完全重启 Claude Desktop（退出，而不仅仅是关闭窗口）。

2. 单击🔌图标以验证服务器是否出现在“已安装的 MCP 服务器”列表中。

3. 如果服务器没有出现，请检查 Claude 的日志：

   • Windows ： %APPDATA%\Claude\Logs\mcp*.log或%LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log

   • macOS ： ~/Library/Logs/Claude/mcp*.log

安全注意事项

此服务器将使用您的用户权限执行命令。请采取以下预防措施：

• 仅在虚拟机或一次性开发环境中使用。

• 切勿在生产系统或具有敏感数据的机器上使用。

• 如果需要，请考虑实施命令限制。

• 监控系统访问和活动。

• 保留重要数据的备份。

免责声明：开发者对因使用本软件而造成的任何损害或损失不承担任何责任。请自行承担使用风险。

故障排除

如果您遇到问题：

1. 检查日志：

   • Windows ： %APPDATA%\Claude\Logs\mcp*.log或%LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log

   • macOS ： ~/Library/Logs/Claude/mcp*.log

2. 验证安装：

   • 确保uv已正确安装并位于您的 PATH 中。

   • 检查mcp包是否已安装： pip show mcp 。

   • 验证 Python 版本是否为 3.10 或更高版本。

3. 配置问题：

   • 仔细检查claude_desktop_config.json中的所有路径。

   • 验证 JSON 语法是否有效。

   • 确保您的操作系统的路径分隔符正确。

   • 确认配置文件位于正确的位置。

4. 环境问题：

   • 如果使用，请确保virtualenv已激活。

   • 验证PYTHONPATH是否设置正确。

   • 检查文件权限。

5. 手动测试服务器：

   # First, make sure you're in the Lilith-Shell directory:
   cd /path/to/cloned/Lilith-Shell
   
   # For macOS:
   ./venv/bin/python src/lilith_shell/executor.py
   
   # For Windows:
   .\venv\Scripts\python.exe src\lilith_shell\executor.py
   
   # The executor will appear to hang with no output - this is normal.
   # It's waiting for connections from Claude Desktop.
   # Use Ctrl+C to stop it.

6. 连接问题：

   • 如果您收到“无法连接到 MCP 服务器”错误，请确保您在配置文件中使用虚拟环境的 Python 解释器。

   • 对于 macOS：使用/path/to/cloned/Lilith-Shell/venv/bin/python

   • 对于 Windows：使用C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exe

测试

设置完成后，在 Claude Desktop 中尝试以下命令：

Can you run 'pwd' and tell me what directory we're in?

或者

Can you list the files in my home directory? Which of them are larger than 200 MB?

致谢

该项目是 Christian Hägg 从Pandoras-Shell分支而来，在安全性、测试和功能方面均有显著增强。原始项目为 Lilith Shell 提供了基础和灵感。