local-only server

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

명령 실행자 MCP 서버

사전 승인된 명령을 안전하게 실행하기 위한 모델 컨텍스트 프로토콜 서버입니다.

🎥 데모

https://github.com/user-attachments/assets/ed763a12-b685-4e0b-b9a5-bc948a590f51

✨ 특징

사전 승인된 명령 목록을 통한 안전한 명령 실행
환경 변수를 통해 구성 가능한 허용 명령
TypeScript 및 MCP SDK로 구축됨
원활한 통합을 위한 stdio를 통한 통신
오류 처리 및 보안 검증
실시간 명령 출력 스트리밍

🚀 설치

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

⚙️ 구성

🔒 허용된 명령어

기본적으로 다음 명령이 허용됩니다.

git
엘에스
mkdir
CD
엔피엠
엔피엑스
파이썬

ALLOWED_COMMANDS 환경 변수를 설정하여 허용되는 명령을 사용자 정의할 수 있습니다.

export ALLOWED_COMMANDS=git,ls,mkdir,python

🔌 Claude 데스크톱 통합

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows의 경우:

%APPDATA%/Claude/claude_desktop_config.json

구성 예:

{
  "mcpServers": {
    "command-executor": {
      "command": "/path/to/command-executor/build/index.js"
    }
  }
}

🛡️ 보안 고려 사항

명령 실행 서버는 여러 가지 보안 조치를 구현합니다.

사전 승인된 명령 목록
- 명시적으로 허용된 명령만 실행할 수 있습니다.
- 기본 목록은 제한적이고 보안에 중점을 둡니다.
- 명령은 주입을 방지하기 위해 접두사로 검증됩니다.
명령 검증
- 명령어 접두사 검증으로 명령어 주입이 방지됩니다.
- 보안 강화를 위해 셸 실행 없음
- 환경 변수가 적절하게 정리되었습니다.
오류 처리
- 허가되지 않은 명령에 대한 포괄적인 오류 처리
- 디버깅을 위한 오류 메시지 지우기
- 실패한 명령으로 인해 서버가 충돌하지 않습니다.
환경 격리
- 서버는 자체 환경에서 실행됩니다.
- 환경 변수를 제어할 수 있습니다
- 제한된 시스템 접근

💻 개발

📁 프로젝트 구조

command-executor/
├─ src/
│  └─ index.ts      # Main server implementation
├─ build/
│  └─ index.js      # Compiled JavaScript
├─ assets/
│  └─ header.svg    # Project header image
└─ package.json     # Project configuration

🐛 디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

🛠️ 도구 API

서버는 단일 도구를 제공합니다.

실행 명령

미리 승인된 명령을 실행합니다.

매개변수:

command (문자열, 필수): 실행할 명령

요청 예시:

{
  "name": "execute_command",
  "arguments": {
    "command": "git status"
  }
}

응답 예시:

{
  "content": [
    {
      "type": "text",
      "text": "On branch main\nNothing to commit, working tree clean"
    }
  ]
}

오류 응답:

{
  "content": [
    {
      "type": "text",
      "text": "Command execution failed: Command not allowed"
    }
  ],
  "isError": true
}

❌ 오류 처리

서버는 다양한 시나리오에 대한 자세한 오류 메시지를 제공합니다.

허가되지 않은 명령
{ "code": "InvalidParams", "message": "Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python" }
실행 실패
{ "content": [ { "type": "text", "text": "Command execution failed: [error message]" } ], "isError": true }

🤝 기여하기

저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
새로운 풀 리퀘스트 만들기

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

execute_command

사전 승인된 명령을 안전하게 실행할 수 있는 모델 컨텍스트 프로토콜 서버로, AI 보조자가 사용자 시스템과 안전하게 상호 작용할 수 있도록 지원합니다.

Related Resources

Reddit Discussion about this server

Command Executor MCP Server