莉莉丝壳

⚠️重要安全警告：此 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 提供了基础和灵感。