dynamic-shell-server

Overview

The dynamic-shell-server is a Model Context Protocol implementation that provides secure execution of shell commands. Its core feature is a dynamic approval system requiring user confirmation before running commands, with options to allow once or permanently remember approvals. The server maintains comprehensive audit logs and stores approved commands persistently. It includes security features like command timeout protection and revocation capabilities, making it suitable for environments where shell access is needed but security is paramount.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• execute_command

  Execute a shell command with optional arguments

  Try:Run 'npm install' in my project directoryTry:Execute 'ls -la' to list filesTry:Show me disk usage with 'df -h'
• revoke_command_approval

  Revoke approval for a previously approved command

  Try:Revoke approval for 'rm -rf'Try:Remove approval for the command 'systemctl restart nginx'Try:I want to revoke approval for 'sudo rm -rf /'

Comparable tools

Installation

git clone <repository-url>
cd dynamic-shell-server

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

pip install -r requirements.txt

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

FAQ

How does the approval system work?

When running a command for the first time, users are prompted with options to allow once, allow and remember for future use, or deny execution. Approved commands are stored in ~/.config/mcp-shell-server/approved_commands.json.

What happens if a command times out?

The server implements a 5-minute timeout for all commands. If a command doesn't complete within this timeframe, it's automatically terminated and recorded in the audit log.

Compare dynamic-shell-server with