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에서 수신된 확인 ID

• confirm (부울, 필수): 명령 실행을 진행할지 여부

안전 기능

위험한 명령 감지

서버는 다음을 포함하여 실행하기 전에 명시적인 확인이 필요한 잠재적으로 위험한 명령 목록을 유지 관리합니다.

• 파일 시스템 작업(rm, rmdir, mv)

• 시스템 명령(종료, 재부팅)

• 패키지 관리(apt, yum, dnf)

• 파일 리디렉션(>, >>)

• 권한 변경(chmod, chown)

• 그리고 더 많은 것...

명령 살균

모든 명령은 다음을 방지하기 위해 정리되었습니다.

• 셸 메타문자 주입

• 경로 탐색 시도

• 홈 디렉토리 참조

• 위험한 명령 체이닝

개발

설정

1. 저장소를 복제합니다

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

4. 개발 모드에서 실행:

출판

이 프로젝트에서는 버전 관리를 위해 변경 세트를 사용합니다. 게시하려면 다음을 수행하세요.

1. 변경 세트를 만듭니다.

2. 패키지 버전:

3. npm에 게시:

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

• 모델 컨텍스트 프로토콜을 기반으로 구축됨

• 안전한 WSL 명령 실행을 위해 설계되었습니다.