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

1. 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

2. 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.

3. 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

4. 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

1. Requisitos previos de instalación:

   brew install python git uv

2. 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

3. Instalar dependencias:

   uv pip install -e ".[dev]"

Configuración

Ventanas

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

1. %APPDATA%\Claude\ (normalmente C:\Users\[YourUsername]\AppData\Roaming\Claude\ )

2. %LOCALAPPDATA%\AnthropicClaude\ (normalmente C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ )

Cree o edite claude_desktop_config.json en el directorio correcto:

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 :

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

1. Reinicie Claude Desktop por completo (salga, no solo cierre la ventana).

2. Haga clic en el ícono 🔌 para verificar que el servidor aparezca en la lista "Servidores MCP instalados".

3. 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:

1. Comprobar registros:

   • Windows : %APPDATA%\Claude\Logs\mcp*.log o %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log

   • macOS : ~/Library/Logs/Claude/mcp*.log

2. 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.

3. 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.

4. Cuestiones medioambientales:

   • Asegúrese de que virtualenv esté activado si utiliza uno.

   • Verifique que PYTHONPATH esté configurado correctamente.

   • Verifique los permisos de archivos.

5. 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.

6. 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:

o

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.