Lilith-Shell

Lilith-Shell

0

Lilith Shell is an advanced MCP server that allows AI assistants to execute terminal commands with enhanced security controls. It is highly compatible with Claude Desktop, offering comprehensive support for all MCP features. This project should be used responsibly due to the security risks associated with executing shell commands.

Lilith Shell

⚠️ IMPORTANT SECURITY WARNING: This MCP server grants AI assistants unrestricted ability to execute terminal commands on your system. Only use in controlled environments like virtual machines (VMs) or development systems you can afford to rebuild.

Features

  • Execute shell commands with security validation
  • Capture command output (stdout/stderr)
  • Set working directory
  • Handle command timeouts
  • Improved test coverage
  • Enhanced security controls
  • FastMCP integration

Installation

Prerequisites

  • Claude Desktop with an active Claude Pro/Enterprise subscription
  • Python 3.10 or higher
  • Git
  • uv (required for package management)

Windows Installation

  1. Install Prerequisites
  2. Install uv
  3. Clone and set up the project
  4. Install dependencies

macOS Installation

  1. Install Prerequisites
  2. Clone and set up the project
  3. Install dependencies

Configuration

Windows

  • Create or edit claude_desktop_config.json

macOS

  • Create or edit claude_desktop_config.json

Security Considerations

  • Use only in VMs or disposable development environments.
  • Never use on production systems or machines with sensitive data.

Troubleshooting

  • Check logs
  • Verify installation
  • Configuration issues
  • Environment issues
  • Test server manually
  • Connection issues

Acknowledgments

This project is a fork of Pandoras-Shell by Christian Hägg.