local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
mcp-wsl-exec
Linux용 Windows 하위 시스템(WSL) 환경에서 명령을 실행하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 내장된 보안 기능과 검증 기능을 통해 안전한 명령 실행을 제공합니다.
특징
- 🔒 WSL 환경에서 안전한 명령 실행
- ⚡ 내장된 안전 기능:
- 위험한 명령 감지
- 명령 확인 시스템
- 경로 탐색 방지
- 명령 살균
- 📁 작업 디렉토리 지원
- ⏱️ 명령 시간 초과 기능
- 🔍 자세한 명령 출력 형식
- ❌ 오류 처리 및 검증
- 🛡️ 쉘 주입에 대한 보호
구성
이 서버를 사용하려면 MCP 클라이언트를 통한 구성이 필요합니다. 다음은 다양한 환경에 대한 예시입니다.
클라인 구성
Cline MCP 설정에 다음을 추가하세요.
지엑스피1
클로드 데스크톱 구성
Claude Desktop 구성에 다음을 추가하세요.
API
서버는 두 가지 MCP 도구를 구현합니다.
실행 명령
안전 검사 및 검증을 통해 WSL에서 명령을 실행합니다.
매개변수:
command(문자열, 필수): 실행할 명령working_dir(문자열, 선택 사항): 명령 실행을 위한 작업 디렉토리timeout(숫자, 선택 사항): 밀리초 단위의 시간 초과
확인_명령
안전 검사를 통해 표시된 위험한 명령의 실행을 확인합니다.
매개변수:
confirmation_id(문자열, 필수): execute_command에서 수신된 확인 IDconfirm(부울, 필수): 명령 실행을 진행할지 여부
안전 기능
위험한 명령 감지
서버는 다음을 포함하여 실행하기 전에 명시적인 확인이 필요한 잠재적으로 위험한 명령 목록을 유지 관리합니다.
- 파일 시스템 작업(rm, rmdir, mv)
- 시스템 명령(종료, 재부팅)
- 패키지 관리(apt, yum, dnf)
- 파일 리디렉션(>, >>)
- 권한 변경(chmod, chown)
- 그리고 더 많은 것...
명령 살균
모든 명령은 다음을 방지하기 위해 정리되었습니다.
- 셸 메타문자 주입
- 경로 탐색 시도
- 홈 디렉토리 참조
- 위험한 명령 체이닝
개발
설정
- 저장소를 복제합니다
- 종속성 설치:
- 프로젝트를 빌드하세요:
- 개발 모드에서 실행:
출판
이 프로젝트에서는 버전 관리를 위해 변경 세트를 사용합니다. 게시하려면 다음을 수행하세요.
- 변경 세트를 만듭니다.
- 패키지 버전:
- npm에 게시:
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.
감사의 말
- 모델 컨텍스트 프로토콜을 기반으로 구축됨
- 안전한 WSL 명령 실행을 위해 설계되었습니다.
You must be authenticated.
Linux 환경의 Windows 하위 시스템을 위한 안전한 MCP 서버로, 셸 주입 및 위험한 명령과 같은 취약점에 대한 광범위한 검증 및 보호 기능을 통해 안전한 명령 실행을 용이하게 합니다.