🚀 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文件。
验证安装
- 确保
uv已正确安装并添加到 PATH 环境变量中。 - 检查
mcp包是否已安装：pip show mcp - 确认 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 开发，增加了更多安全性和功能性改进，你可以参考原项目获取更多信息。