Dynamic ShellSAFE

A Model Context Protocol (MCP) server that enables secure execution of shell commands with a dynamic approval system. This server allows running arbitrary commands while maintaining security through user approval and audit logging.

Features

• 🔐 Dynamic command approval system
• 📝 Persistent storage of approved commands
• 📊 Comprehensive audit logging
• ⏱️ Command timeout protection
• 🔄 Command revocation capability

Installation

1. Clone this repository:

git clone 
cd dynamic-shell-server

1. Create a virtual environment and activate it:

python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

1. Install dependencies:

pip install -r requirements.txt

Usage

Standalone Mode

Run the server directly:

python dynamic_shell_server.py

Claude Desktop Integration

1. Open your Claude Desktop configuration:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Add the server configuration:

{
"mcpServers": {
"shell": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/dynamic_shell_server.py"]
}
}
}

1. Restart Claude Desktop

Command Approval Process

When running a command for the first time, you'll be prompted with:

Command Approval Required

Command: 
Arguments: 

This command has not been previously approved. Do you want to:
1. Allow this command once
2. Allow this command and remember for future use
3. Deny execution

Please choose an option (1-3):

Available Tools

1. execute_command: Execute a shell command
2. Parameters:
3. command: The command to execute
4. args: Optional list of command arguments

1. revoke_command_approval: Revoke approval for a previously approved command
2. Parameters: