Lilith Shell

莉莉丝贝壳


MCP服务器使AI助手能够安全地执行终端命令。

安全警告

此工具允许AI代理shell访问您的系统。 仅在受控环境中使用。部署前检查所有安全设置。了解风险。

为什么存在

您希望Claude运行shell命令，但需要安全防护。直接接触外壳是危险的。没有访问限制。此服务器提供中间地带：具有超时保护、错误处理和安全验证的受控命令执行。

它做什么

为Claude Desktop提供安全的shell命令执行：

• 命令执行 -通过MCP协议运行终端命令
• 超时保护 -命令在可配置的持续时间后自动终止
• 安全验证 -执行前命令分析和过滤
• 错误处理 -带上下文的结构化错误响应
• 交叉平台的 -适用于macOS和Windows（PowerShell+cmd）

技术栈

• Python 3.10+
• FastMCP用于模型上下文协议集成
• 跨平台子流程管理
• 安全第一架构

主要特点

安全控制

• 命令允许列表 -允许命令的可选白名单
• 危险指令检测 -阻止破坏性操作（rm-rf、格式化等）
• 超时强制 -杀死失控的进程
• 工作目录控制 -限制命令执行路径
• 输出消毒 -从响应中过滤敏感数据

执行功能

• 异步操作 -非阻塞命令执行
• 流输出 -实时命令输出流
• 退出代码处理 -正确的成功/失败检测
• 环境变量 -受控环境传递
• 外壳选择 -选择bash、zsh、PowerShell或cmd

快速开始

安装-macOS

pip install lilith-shell

添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "lilith-shell": {
      "command": "python",
      "args": ["-m", "lilith_shell"],
      "env": {
        "LILITH_TIMEOUT": "30",
        "LILITH_SHELL": "bash"
      }
    }
  }
}

安装-Windows

pip install lilith-shell

添加到Claude桌面配置(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "lilith-shell": {
      "command": "python",
      "args": ["-m", "lilith_shell"],
      "env": {
        "LILITH_TIMEOUT": "30",
        "LILITH_SHELL": "powershell"
      }
    }
  }
}

重新启动克劳德桌面。

配置

环境变量

• LILITH_TIMEOUT -命令超时（秒）（默认值：30）
• LILITH_SHELL -要使用的Shell（bash/zsh/powershell/cmd）
• LILITH_ALLOW_LIST -逗号分隔的允许命令列表
• LILITH_WORK_DIR -将执行限制在特定目录
• LILITH_MAX_OUTPUT -最大输出大小（字节）（默认值：1MB）

安全模式

允许模式 （默认）-阻止明显的危险命令：

{
  "env": {
    "LILITH_MODE": "permissive"
  }
}

严格模式 -仅执行分配的命令：

{
  "env": {
    "LILITH_MODE": "strict",
    "LILITH_ALLOW_LIST": "git,npm,pip,ls,cat,grep"
  }
}

锁定模式 -只读操作：

{
  "env": {
    "LILITH_MODE": "lockdown"
  }
}

建筑

lilith-shell/
├── core/
│   ├── executor.py           # Command execution engine
│   ├── security.py           # Security validation
│   └── timeout.py            # Timeout management
├── platform/
│   ├── unix.py               # macOS/Linux implementation
│   ├── windows.py            # Windows implementation
│   └── base.py               # Platform interface
├── utils/
│   ├── config.py             # Configuration management
│   ├── logger.py             # Audit logging
│   └── sanitizer.py          # Output sanitization
└── server.py                 # MCP server entry point

设计原则

1. 安全第一 -每个命令在执行前都经过验证
2. 故障安全 -严格模式下默认拒绝未知命令
3. 可审计性 -所有记录有时间戳和结果的命令
4. 隔离 -无法访问shell历史记录或持久状态
5. MCP本地 -与模型上下文协议的干净集成

用法

当需要执行命令时，Claude Desktop会自动使用shell服务器。交互示例：

User: "List files in the current directory"
Claude: *executes `ls -la` via Lilith Shell*

User: "Install dependencies"
Claude: *executes `npm install` via Lilith Shell*

阻止命令（许可模式）

为了安全起见，默认情况下会阻止这些命令：

• rm -rf, rm -fr -递归删除
• format, mkfs -文件系统格式化
• dd -低级磁盘操作
• chmod 777 -危险的权限更改
• curl | sh, wget | sh -管道到外壳的执行
• sudo 没有特定的同种异体条目
• PowerShell Remove-Item -Recurse

未来想法

• 命令允许列表UI -用于管理允许命令的Web界面
• 审计日志 -具有回放功能的全面命令历史记录
• Linux支持 -Linux发行版的全面测试和优化
• 沙盒模式 -在隔离容器中执行命令
• 命令模板 -预先批准的带参数的命令模式
• 速率限制 -防止命令垃圾邮件/滥用
• 多用户支持 -每个用户的安全配置文件
• 输出流UI -实时命令输出可视化

安全最佳实践

1. 在生产中使用严格模式 -允许列表特定命令
2. 设置保守超时 -防止资源枯竭
3. 监控审核日志 -定期查看命令历史记录
4. 限制工作目录 -限制文件系统访问范围
5. 审查AI请求 -批准前了解命令
6. 使用环境隔离 -在专用开发环境中运行
7. 保持更新 -及时应用安全补丁

故障排除

命令超时

增加超时时间： "LILITH_TIMEOUT": "60"

权限被拒绝错误

检查工作目录权限和命令列表。

命令未执行

1. 验证MCP服务器是否正在运行：检查Claude Desktop日志
2. 检查安全模式：可能在严格/锁定模式下被阻止
3. 查看审核日志： ~/.config/lilith-shell/logs/audit.log

发展

# Clone repository
git clone https://github.com/charles-adedotun/Lilith-Shell.git
cd lilith-shell

# Install dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Security audit
bandit -r src/

# Type checking
mypy src/

贡献

安全问题得到优先考虑。针对漏洞打开私人安全咨询。对于功能，先打开一个问题来讨论方法。严格进行安全验证。

许可证

麻省理工学院

致谢

专为需要在没有混乱的情况下访问AI shell的开发人员而设计。负责任地使用。