Lilith Shell
@charles-adedotun
About Lilith Shell
An MCP (Model Context Protocol) server that enables AI assistants to execute terminal commands securely.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"Lilith-Shell": {
"command": "python3",
"args": [
"-m",
"venv",
"venv"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Lilith Shell?
Lilith Shell is an experimental MCP server that exposes local shell command execution to an AI assistant. It is a prototype intended for development and testing, not for production use.
How to use Lilith Shell?
Install from source using pip install -e ".[dev]" after cloning the repository, then run the MCP server in your AI assistant client. The server registers one tool, execute_command, which accepts a command string and an optional directory string (defaults to ~).
Key features of Lilith Shell
- Exposes one MCP tool:
execute_command - Executes commands via
subprocess.run(..., shell=True) - Returns exit code, stdout, and stderr
- Fixed five-minute timeout per command
- Accepts an optional working directory
Use cases of Lilith Shell
- Experimenting with MCP server development
- Testing local command execution with an AI assistant
- Prototyping security models for shell access
FAQ from Lilith Shell
What security controls does Lilith Shell have?
The current implementation has no command allowlist, no denylist, no environment filtering, no output sanitization, and no audit log. It uses shell=True with untrusted tool input.
Can Lilith Shell be used in production?
No. The README warns against running it on any host, account, or directory containing credentials, production data, private source code, SSH keys, or cloud tokens. It is strictly a prototype.
What platforms does Lilith Shell support?
The README does not specify supported platforms beyond general Python execution. No Windows-specific execution path is implemented.
How do I install and run tests?
Use pip install -e ".[dev]" to install in development mode, then run pytest to execute tests.
What was de-scoped from the original plan?
Capabilities like command allowlisting, dangerous command detection, configurable modes, output sanitization, audit logging, working-directory confinement, cross-platform shell selection, and streaming output are not present in the current code.
Frequently asked questions
What security controls does Lilith Shell have?
The current implementation has no command allowlist, no denylist, no environment filtering, no output sanitization, and no audit log. It uses `shell=True` with untrusted tool input.
Can Lilith Shell be used in production?
No. The README warns against running it on any host, account, or directory containing credentials, production data, private source code, SSH keys, or cloud tokens. It is strictly a prototype.
What platforms does Lilith Shell support?
The README does not specify supported platforms beyond general Python execution. No Windows-specific execution path is implemented.
How do I install and run tests?
Use `pip install -e ".[dev]"` to install in development mode, then run `pytest` to execute tests.
What was de-scoped from the original plan?
Capabilities like command allowlisting, dangerous command detection, configurable modes, output sanitization, audit logging, working-directory confinement, cross-platform shell selection, and streaming output are not present in the current code.
Basic information
More Developer Tools MCP servers
Altronis
sypherinMCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.
Vibgrate MCP
VibgrateQuery your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up
CircleCI MCP Server
CircleCIManage CI/CD pipelines, debug failed builds, and optimize test suites directly from your AI agents - no terminal required. The CircleCI MCP Server is a remote server hosted by CircleCI that connects AI tools and agents
PuzzleTide Puzzle Generator
Caravaca-LabsWord search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers
Skycloak
Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.
Comments