local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides a secure interface to execute shell commands on the host system with features such as command output capture, working directory specification, command timeouts, and enhanced security controls.

Concha de Lilith

⚠️ ADVERTENCIA IMPORTANTE DE SEGURIDAD : Este servidor MCP permite a los asistentes de IA ejecutar comandos de terminal sin restricciones en su sistema. Úselo solo en entornos controlados, como máquinas virtuales (VM) o sistemas de desarrollo que pueda reconstruir.

Acerca de

Lilith Shell es un servidor MCP mejorado que permite a los asistentes de IA ejecutar comandos de terminal en su sistema con controles y pruebas de seguridad mejorados. Debido al acceso sin restricciones que proporciona, es crucial usar este software con responsabilidad y ser plenamente consciente de los riesgos de seguridad que conlleva.

Nota : Este servidor es compatible con cualquier asistente de IA compatible con el Protocolo de Contexto de Modelo (MCP). Las instrucciones de configuración proporcionadas están diseñadas específicamente para Claude Desktop, que ofrece compatibilidad completa con todas las funciones de MCP.

Características

Ejecutar comandos de shell con validación de seguridad
Capturar la salida del comando (stdout/stderr)
Establecer directorio de trabajo
Manejar tiempos de espera de comandos
Cobertura de pruebas mejorada
Controles de seguridad mejorados
Integración de FastMCP

API

Herramientas

ejecutar_comando
- Ejecutar comandos de shell y devolver su salida
- Entradas :
  - command (cadena): Comando a ejecutar
  - directory (cadena, opcional): Directorio de trabajo
- Devoluciones :
  - Código de salida del comando
  - Salida estándar
  - Error estándar
- Características :
  - tiempo muerto de 5 minutos
  - Soporte de directorio de trabajo
  - Manejo de errores
  - Validación de seguridad

Instalación

Prerrequisitos

Claude Desktop con una suscripción activa a Claude Pro/Enterprise
- Descargar desde: Claude AI
Python 3.10 o superior
Git
uv (necesario para la gestión de paquetes)

Instalación de Windows

Requisitos previos de instalación:Opción A - Usar winget (si está disponible en su sistema):
winget install python git
Opción B - Instalación manual (recomendada):
- Descargue e instale Python desde python.org
- Descargue e instale Git desde git-scm.com
Instalar uv:Abra el símbolo del sistema ( cmd.exe ) como administrador y ejecute:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Si encuentra algún problema, es posible que deba reiniciar su terminal o computadora para que los cambios surtan efecto.
Clonar y configurar el proyecto:
git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell
Luego crea un entorno virtual. Prueba estos comandos en orden hasta que uno funcione:
python -m venv venv
Si esto no funciona, prueba:
python3 -m venv venv
Luego activa el entorno:
venv\Scripts\activate
Instalar dependencias:
uv pip install -e ".[dev]"

Nota : Si instalaste Python desde python.org , normalmente usarás python . Si lo instalaste mediante winget o desde la Microsoft Store, podrías necesitar usar python3 . Prueba ambos comandos si uno no funciona.

Instalación de macOS

Requisitos previos de instalación:
brew install python git uv
Clonar y configurar el proyecto:
git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell python3 -m venv venv source venv/bin/activate
Instalar dependencias:
uv pip install -e ".[dev]"

Configuración

Ventanas

Localice el directorio de configuración correcto: pruebe estas rutas en orden:

%APPDATA%\Claude\ (normalmente C:\Users\[YourUsername]\AppData\Roaming\Claude\ )
%LOCALAPPDATA%\AnthropicClaude\ (normalmente C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ )

Cree o edite claude_desktop_config.json en el directorio correcto:

{
  "mcpServers": {
    "lilith-shell": {
      "command": "C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exe",
      "args": [
        "C:/path/to/cloned/Lilith-Shell/src/lilith_shell/executor.py"
      ],
      "env": {
        "PYTHONPATH": "C:/path/to/cloned/Lilith-Shell/src"
      }
    }
  }
}

Notas importantes para Windows:

Utilice barras diagonales ( / ) en las rutas, no barras diagonales inversas ( \ )
Reemplace [YourUsername] con su nombre de usuario real de Windows
El archivo debe llamarse exactamente claude_desktop_config.json
Si existen ambas ubicaciones de configuración posibles, pruebe cada una hasta que tenga éxito

macOS

Cree o edite ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "lilith-shell": {
      "command": "/path/to/cloned/Lilith-Shell/venv/bin/python",
      "args": [
        "/path/to/cloned/Lilith-Shell/src/lilith_shell/executor.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/cloned/Lilith-Shell/src"
      }
    }
  }
}

Notas importantes para macOS:

Reemplace [YourUsername] con su nombre de usuario real
Puede utilizar $HOME en lugar de /Users/[YourUsername] si lo prefiere
El archivo debe llamarse exactamente claude_desktop_config.json
La ruta command debe apuntar al intérprete de Python dentro de su entorno virtual ( venv/bin/python ), no al sistema Python.

Después de la configuración

Reinicie Claude Desktop por completo (salga, no solo cierre la ventana).
Haga clic en el ícono 🔌 para verificar que el servidor aparezca en la lista "Servidores MCP instalados".
Si el servidor no aparece, revise los registros de Claude:
- Windows : %APPDATA%\Claude\Logs\mcp*.log o %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
- macOS : ~/Library/Logs/Claude/mcp*.log

Consideraciones de seguridad

Este servidor ejecuta comandos con sus privilegios de usuario. Tome estas precauciones:

Úselo solo en máquinas virtuales o entornos de desarrollo desechables.
Nunca lo use en sistemas de producción o máquinas con datos confidenciales.
Considere implementar restricciones de comando si es necesario.
Supervisar el acceso y la actividad del sistema.
Mantenga copias de seguridad de los datos importantes.

Aviso legal : Los desarrolladores no se hacen responsables de ningún daño o pérdida que resulte del uso de este software. Úselo bajo su propia responsabilidad.

Solución de problemas

Si encuentra problemas:

Comprobar registros:
- Windows : %APPDATA%\Claude\Logs\mcp*.log o %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
- macOS : ~/Library/Logs/Claude/mcp*.log
Verificar la instalación:
- Asegúrese de que uv esté instalado correctamente y en su RUTA.
- Compruebe que el paquete mcp esté instalado: pip show mcp .
- Verifique que la versión de Python sea 3.10 o superior.
Problemas de configuración:
- Verifique nuevamente todas las rutas en claude_desktop_config.json .
- Verifique que la sintaxis JSON sea válida.
- Asegúrese de que los separadores de ruta sean adecuados para su sistema operativo.
- Confirme que el archivo de configuración esté en la ubicación correcta.
Cuestiones medioambientales:
- Asegúrese de que virtualenv esté activado si utiliza uno.
- Verifique que PYTHONPATH esté configurado correctamente.
- Verifique los permisos de archivos.
Probar el servidor manualmente:
# 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.
Problemas de conexión:
- Si recibe errores "No se pudo conectar al servidor MCP", asegúrese de estar utilizando el intérprete de Python del entorno virtual en su archivo de configuración.
- Para macOS: utilice /path/to/cloned/Lilith-Shell/venv/bin/python
- Para Windows: utilice C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exe

Pruebas

Después de la configuración, pruebe estos comandos en Claude Desktop:

Can you run 'pwd' and tell me what directory we're in?

o

Can you list the files in my home directory? Which of them are larger than 200 MB?

Expresiones de gratitud

Este proyecto es una bifurcación de Pandoras-Shell de Christian Hägg, con mejoras significativas en seguridad, pruebas y funcionalidad. El proyecto original sentó las bases e inspiró Lilith Shell.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor MCP mejorado que otorga a los asistentes de IA la capacidad de ejecutar comandos de terminal en el sistema de un usuario con controles de seguridad mejorados, diseñado para su uso en entornos controlados.