莉莉丝壳

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

关于

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

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

特征

• 执行带有安全验证的 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 ：

Windows 重要说明：

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

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

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

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

macOS

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

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 中尝试以下命令：

或者

致谢

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