릴리스 셸

⚠️ 중요 보안 경고 : 이 MCP 서버는 AI 어시스턴트가 사용자 시스템에서 터미널 명령을 실행할 수 있는 무제한 권한을 부여합니다. 가상 머신(VM)이나 재구축이 가능한 개발 시스템과 같이 통제된 환경에서만 사용하십시오.

에 대한

Lilith Shell은 향상된 보안 제어 및 테스트를 통해 AI 비서가 시스템에서 터미널 명령을 실행할 수 있도록 지원하는 향상된 MCP 서버입니다. 이 서버는 무제한적인 접근 권한을 제공하므로, 이 소프트웨어를 책임감 있게 사용하고 관련된 보안 위험을 충분히 인지하는 것이 중요합니다.

참고 : 이 서버는 MCP(Model Context Protocol)를 지원하는 모든 AI 어시스턴트와 호환됩니다. 제공된 구성 및 설정 지침은 모든 MCP 기능을 포괄적으로 지원하는 Claude Desktop에 맞춰 특별히 제작되었습니다.

특징

• 보안 검증을 통해 셸 명령 실행

• 명령 출력 캡처(stdout/stderr)

• 작업 디렉토리 설정

• 명령 시간 초과 처리

• 개선된 테스트 범위

• 강화된 보안 제어

• FastMCP 통합

API

도구

• 실행 명령

  • 셸 명령을 실행하고 출력을 반환합니다.

  • 입력 :

    • command (문자열): 실행할 명령

    • directory (문자열, 선택 사항): 작업 디렉토리

  • 반품 :

    • 명령 종료 코드

    • 표준 출력

    • 표준 오차

  • 특징 :

    • 5분 타임아웃

    • 작업 디렉토리 지원

    • 오류 처리

    • 보안 검증

설치

필수 조건

• Claude Pro/Enterprise 구독이 활성화된 Claude Desktop

  • 다운로드: Claude AI

• Python 3.10 이상

• 깃

• uv (패키지 관리에 필요)

윈도우 설치

1. 설치 필수 조건:

   옵션 A - winget 사용(시스템에서 사용 가능한 경우):

   지엑스피1

   옵션 B - 수동 설치(권장):

   • python.org 에서 Python을 다운로드하고 설치하세요

   • git-scm.com 에서 Git을 다운로드하고 설치하세요

2. uv 설치:

   관리자 권한으로 명령 프롬프트( cmd.exe )를 열고 다음을 실행합니다.

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

   문제가 발생하면 변경 사항을 적용하기 위해 터미널이나 컴퓨터를 다시 시작해야 할 수도 있습니다.

3. 프로젝트를 복제하고 설정합니다.

   git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell

   그런 다음 가상 환경을 만드세요. 다음 명령어를 순서대로 시도하여 하나가 작동할 때까지 시도해 보세요.

   python -m venv venv

   그래도 문제가 해결되지 않으면 다음을 시도해 보세요.

   python3 -m venv venv

   그런 다음 환경을 활성화합니다.

   venv\Scripts\activate

4. 종속성 설치:

   uv pip install -e ".[dev]"

참고 : python.org 에서 Python을 설치한 경우 일반적으로 python 사용합니다. winget이나 Microsoft Store를 통해 설치한 경우 python3 사용해야 할 수 있습니다. 두 명령 중 하나가 작동하지 않으면 두 명령을 모두 시도해 보세요.

macOS 설치

1. 설치 필수 조건:

   brew install python git uv

2. 프로젝트를 복제하고 설정합니다.

   git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell python3 -m venv venv source venv/bin/activate

3. 종속성 설치:

   uv pip install -e ".[dev]"

구성

윈도우

올바른 구성 디렉토리를 찾으세요. 다음 경로를 순서대로 시도해 보세요.

1. %APPDATA%\Claude\ (일반적으로 C:\Users\[YourUsername]\AppData\Roaming\Claude\ )

2. %LOCALAPPDATA%\AnthropicClaude\ (일반적으로 C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ )

올바른 디렉토리에서 claude_desktop_config.json 만들거나 편집하세요.

Windows에 대한 중요 참고 사항:

• 경로에는 백슬래시( \ )가 아닌 슬래시( / )를 사용하세요.

• [YourUsername] 실제 Windows 사용자 이름으로 바꾸세요.

• 파일 이름은 정확히 claude_desktop_config.json 이어야 합니다.

• 가능한 두 구성 위치가 모두 존재하는 경우 성공할 때까지 각각을 시도합니다.

맥OS

~/Library/Application Support/Claude/claude_desktop_config.json 생성하거나 편집합니다.

macOS에 대한 중요 참고 사항:

• [YourUsername] 실제 사용자 이름으로 바꾸세요.

• 원하는 경우 /Users/[YourUsername] 대신 $HOME 사용할 수 있습니다.

• 파일 이름은 정확히 claude_desktop_config.json 이어야 합니다.

• command 경로는 시스템 Python이 아닌 가상 환경( venv/bin/python ) 내의 Python 인터프리터를 가리켜야 합니다.

구성 후

1. Claude Desktop을 완전히 다시 시작합니다(창을 닫는 것이 아니라 종료/종료합니다).

2. 🔌 아이콘을 클릭하여 해당 서버가 "설치된 MCP 서버" 목록에 나타나는지 확인하세요.

3. 서버가 나타나지 않으면 Claude의 로그를 확인하세요.

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

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

보안 고려 사항

이 서버는 사용자 권한으로 명령을 실행합니다. 다음 예방 조치를 취하세요.

• VM 이나 일회용 개발 환경에서만 사용하세요.

• 민감한 데이터가 있는 운영 시스템이나 장비에는 절대로 사용하지 마세요 .

• 필요한 경우 명령 제한을 구현하는 것을 고려하세요.

• 시스템 접근 및 활동을 모니터링합니다.

• 중요한 데이터는 백업해 두세요.

면책 조항 : 개발자는 이 소프트웨어 사용으로 인해 발생하는 어떠한 손해나 손실에 대해서도 책임을 지지 않습니다. 사용에 따른 모든 책임은 사용자에게 있습니다.

문제 해결

문제가 발생하는 경우:

1. 로그 확인:

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

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

2. 설치 확인:

   • uv 제대로 설치되었고 PATH에 있는지 확인하세요.

   • mcp 패키지가 설치되었는지 확인하세요: pip show mcp .

   • Python 버전이 3.10 이상인지 확인하세요.

3. 구성 문제:

   • claude_desktop_config.json 에서 모든 경로를 다시 확인하세요.

   • JSON 구문이 유효한지 확인하세요.

   • OS에 맞는 적절한 경로 구분 기호를 사용하세요.

   • 구성 파일이 올바른 위치에 있는지 확인하세요.

4. 환경 문제:

   • virtualenv 사용하는 경우 활성화되어 있는지 확인하세요.

   • PYTHONPATH 올바르게 설정되었는지 확인하세요.

   • 파일 권한을 확인하세요.

5. 수동으로 서버 테스트:

   # 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. 연결 문제:

   • "MCP 서버에 연결할 수 없습니다" 오류가 발생하는 경우 구성 파일에서 가상 환경의 Python 인터프리터를 사용하고 있는지 확인하세요.

   • macOS의 경우: /path/to/cloned/Lilith-Shell/venv/bin/python 사용하세요.

   • Windows의 경우: C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exe 를 사용하세요.

테스트

설치 후 Claude Desktop에서 다음 명령을 시도해 보세요.

또는

감사의 말

이 프로젝트는 Christian Hägg가 개발한 Pandoras-Shell 의 포크로, 보안, 테스트 및 기능 면에서 상당한 개선이 이루어졌습니다. 원래 프로젝트는 Lilith Shell의 기반과 영감을 제공했습니다.