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.

릴리스 셸

⚠️ 중요 보안 경고 : 이 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 (패키지 관리에 필요)

윈도우 설치

설치 필수 조건:옵션 A - winget 사용(시스템에서 사용 가능한 경우):지엑스피1옵션 B - 수동 설치(권장):
- python.org 에서 Python을 다운로드하고 설치하세요
- git-scm.com 에서 Git을 다운로드하고 설치하세요
uv 설치:관리자 권한으로 명령 프롬프트( cmd.exe )를 열고 다음을 실행합니다.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
문제가 발생하면 변경 사항을 적용하기 위해 터미널이나 컴퓨터를 다시 시작해야 할 수도 있습니다.
프로젝트를 복제하고 설정합니다.
git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell
그런 다음 가상 환경을 만드세요. 다음 명령어를 순서대로 시도하여 하나가 작동할 때까지 시도해 보세요.
python -m venv venv
그래도 문제가 해결되지 않으면 다음을 시도해 보세요.
python3 -m venv venv
그런 다음 환경을 활성화합니다.
venv\Scripts\activate
종속성 설치:
uv pip install -e ".[dev]"

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

macOS 설치

설치 필수 조건:
brew install python git uv
프로젝트를 복제하고 설정합니다.
git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell python3 -m venv venv source venv/bin/activate
종속성 설치:
uv pip install -e ".[dev]"

구성

윈도우

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

%APPDATA%\Claude\ (일반적으로 C:\Users\[YourUsername]\AppData\Roaming\Claude\ )
%LOCALAPPDATA%\AnthropicClaude\ (일반적으로 C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ )

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

{
  "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"
      }
    }
  }
}

Windows에 대한 중요 참고 사항:

경로에는 백슬래시( \ )가 아닌 슬래시( / )를 사용하세요.
[YourUsername] 실제 Windows 사용자 이름으로 바꾸세요.
파일 이름은 정확히 claude_desktop_config.json 이어야 합니다.
가능한 두 구성 위치가 모두 존재하는 경우 성공할 때까지 각각을 시도합니다.

맥OS

~/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"
      }
    }
  }
}

macOS에 대한 중요 참고 사항:

[YourUsername] 실제 사용자 이름으로 바꾸세요.
원하는 경우 /Users/[YourUsername] 대신 $HOME 사용할 수 있습니다.
파일 이름은 정확히 claude_desktop_config.json 이어야 합니다.
command 경로는 시스템 Python이 아닌 가상 환경( venv/bin/python ) 내의 Python 인터프리터를 가리켜야 합니다.

구성 후

Claude Desktop을 완전히 다시 시작합니다(창을 닫는 것이 아니라 종료/종료합니다).
🔌 아이콘을 클릭하여 해당 서버가 "설치된 MCP 서버" 목록에 나타나는지 확인하세요.
서버가 나타나지 않으면 Claude의 로그를 확인하세요.
- Windows : %APPDATA%\Claude\Logs\mcp*.log 또는 %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
- macOS : ~/Library/Logs/Claude/mcp*.log

보안 고려 사항

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

VM 이나 일회용 개발 환경에서만 사용하세요.
민감한 데이터가 있는 운영 시스템이나 장비에는 절대로 사용하지 마세요 .
필요한 경우 명령 제한을 구현하는 것을 고려하세요.
시스템 접근 및 활동을 모니터링합니다.
중요한 데이터는 백업해 두세요.

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

문제 해결

문제가 발생하는 경우:

로그 확인:
- Windows : %APPDATA%\Claude\Logs\mcp*.log 또는 %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
- macOS : ~/Library/Logs/Claude/mcp*.log
설치 확인:
- uv 제대로 설치되었고 PATH에 있는지 확인하세요.
- mcp 패키지가 설치되었는지 확인하세요: pip show mcp .
- Python 버전이 3.10 이상인지 확인하세요.
구성 문제:
- claude_desktop_config.json 에서 모든 경로를 다시 확인하세요.
- JSON 구문이 유효한지 확인하세요.
- OS에 맞는 적절한 경로 구분 기호를 사용하세요.
- 구성 파일이 올바른 위치에 있는지 확인하세요.
환경 문제:
- virtualenv 사용하는 경우 활성화되어 있는지 확인하세요.
- PYTHONPATH 올바르게 설정되었는지 확인하세요.
- 파일 권한을 확인하세요.
수동으로 서버 테스트:
# 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.
연결 문제:
- "MCP 서버에 연결할 수 없습니다" 오류가 발생하는 경우 구성 파일에서 가상 환경의 Python 인터프리터를 사용하고 있는지 확인하세요.
- macOS의 경우: /path/to/cloned/Lilith-Shell/venv/bin/python 사용하세요.
- Windows의 경우: C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exe 를 사용하세요.

테스트

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

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

또는

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

감사의 말

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

향상된 보안 제어 기능을 통해 AI 보조자가 사용자 시스템에서 터미널 명령을 실행할 수 있는 기능을 제공하는 향상된 MCP 서버로, 통제된 환경에서 사용하도록 설계되었습니다.