Pre-approved 명령을 실행하기위한 Model Context Protocol 서버.

데모

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

✨ 특징

• 사전 승인된 명령 목록과 보안 명령 실행
• 환경변수를 통한 설정 가능한 명령
• TypeScript 및 MCP SDK 내장
• 원활한 통합을 위한 stdio를 통한 통신
• 오류 처리 및 보안 검증
• 실시간 명령 출력 스트리밍

♨ 설치

의존성 설치:

서버 구축:

auto-rebuild를 가진 발달을 위해:

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

# # # 허용된 명령

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

• git의
• ls의
• 미디
• CD를
• 시간
• npx,
• python의

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

은 Claude 데스크탑 통합

Claude Desktop을 사용하려면 서버 구성을 추가하십시오.

MacOS에서:

Windows에서:

구성 예:

️ 보안 고려

command-executor 서버는 여러 보안 조치를 실행합니다.

1. 사전 승인 명령 목록

• 명시적으로 허용된 명령만 실행할 수 있습니다.
• 기본 목록은 제한 및 보안 중심입니다

A Model Context Protocol server for executing pre-approved commands securely.

🎥 Demo

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

✨ Features

• Secure command execution with pre-approved command list
• Configurable allowed commands through environment variables
• Built with TypeScript and MCP SDK
• Communication via stdio for seamless integration
• Error handling and security validations
• Real-time command output streaming

🚀 Installation

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

⚙️ Configuration

🔒 Allowed Commands

By default, the following commands are allowed:

• git
• ls
• mkdir
• cd
• npm
• npx
• python

You can customize the allowed commands by setting the ALLOWED_COMMANDS environment variable:

export ALLOWED_COMMANDS=git,ls,mkdir,python

🔌 Claude Desktop Integration

To use with Claude Desktop, add the server config:

On MacOS:

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

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuration example:

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

🛡️ Security Considerations

The command-executor server implements several security measures:

1. Pre-approved Command List

   • Only explicitly allowed commands can be executed
   • Default list is restrictive and security-focused
   • Commands are validated by prefix to prevent injection

2. Command Validation

   • Command prefix validation prevents command injection
   • No shell execution for improved security
   • Environment variables are properly sanitized

3. Error Handling

   • Comprehensive error handling for unauthorized commands
   • Clear error messages for debugging
   • Failed commands don’t crash the server

4. Environment Isolation

   • Server runs in its own environment
   • Environment variables can be controlled
   • Limited system access

💻 Development

📁 Project Structure

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

🐛 Debugging