local-only server

The server can only run on the client’s local machine because it depends on local resources.

shell-mcp

쉘 명령 실행 MCP 서버

LLM에 대한 보안 셸 명령 실행 기능을 제공하는 MCP 서버 구현입니다.

특징

보안 실행 : 허용된 명령 및 인수만 허용
리소스 제어 : 메모리 및 CPU 사용량 모니터링
타임아웃 제어 : 장시간 실행되는 명령어의 자동 종료
크기 제한 : 안전을 위한 출력 크기 제한
MCP 통합 : Claude 및 기타 MCP 호환 LLM과 함께 작동합니다.

설치

지엑스피1

Dive Desktop을 사용한 구성

Dive Desktop에서 "+ MCP 서버 추가"를 클릭하세요.
다음 구성을 복사하여 붙여넣으세요.

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/shell-mcp"
      ]
    }
  }
}

도구 문서

shell_ls, shell_pwd, shell_df 등
- 허용 목록에 있는 셸 명령 실행
- 입력:
  - command (문자열, 필수): 실행할 명령
  - args (배열, 선택 사항): 명령 인수
  - timeout (숫자, 선택 사항): 실행 시간 초과(ms)

사용 예

LLM에 다음을 요청하세요.

"Show current directory using shell_pwd"
"List files using shell_ls with -l argument"
"Check disk usage using shell_df with -h argument"

수동 시작

필요한 경우 서버를 수동으로 시작합니다.

npx @kevinwatt/shell-mcp

요구 사항

노드.js 18+
MCP 호환 LLM 서비스

개발

# Install dependencies
npm install

# Watch mode
npm run watch

# Run tests
npm test

# Lint
npm run lint

특허

MIT © Dewei Yen

키워드

엠씨피
껍데기
명령
클로드
LLM
오토메이션

사용 가능한 명령

사용 가능한 셸 명령은 다음과 같습니다.

명령	설명	허용된 인수
엘에스	디렉토리 내용 나열	-l, -a, -h, -R, --도움말, *
고양이	파일 내용을 연결하고 표시합니다.	-n, -b, --도움말, *
비밀번호	현재 작업 디렉토리 표시	없음
디에프	디스크 사용량 표시	-h, -T, --도움말
에코	표시 텍스트	모든 텍스트
추신	프로세스 상태 표시	-e, -f, -u, --도움말
무료	메모리 사용량 표시	-h, -m, -g, --도움말
가동 시간	시스템 가동 시간 표시	없음
날짜	시스템 날짜 및 시간 표시	+%Y-%m-%d, +%H:%M:%S, --도움말
그렙	파일에서 텍스트 패턴 검색	-i, -v, -n, -r, -l, --색상, *
와	누가 로그인했는지, 무엇을 하고 있는지 보여주세요	-h, -s, --no-header, --help
후이즈	WHOIS 도메인 등록 정보 조회	-시간, *
찾다	디렉토리 계층 구조에서 파일 검색	-이름, -유형, -크기, -시간, *
넷스탯	네트워크 연결 정보	-a, -n, -t, -u, -l, -p, --help
엘에스피씨	PCI 장치 나열	-v, -k, -mm, -nn, --도움말
lsusb	USB 장치 나열	-v, -t, -d, -s, --help
파기	DNS 조회 유틸리티	+짧음, +추적, +dnssec, @,
nslookup	DNS 레코드 쿼리	-유형=, -쿼리=, *
아이피	네트워크 장치 및 인터페이스 표시	주소, 링크, 경로, 이웃, -br, *
어디에	바이너리, 소스 및 매뉴얼 파일 찾기	-b, -m, -s, *

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Claude 및 기타 MCP 호환 LLM과의 통합을 위해 설계된, 리소스 및 시간 초과 제어 기능을 갖춘 허용 목록에 있는 셸 명령을 실행하기 위한 안전한 MCP 서버입니다.

Related Resources

Reddit Discussion about this server

Shell-MCP