PermShell MCP

Example Use Cases

• 1

  Execute shell commands on a host machine but require explicit user permission for each action.

• 2

  Gather system information (OS, uptime, memory, disk, CPU) in a standardized MCP tool format.

• 3

  Transparent, auditable command execution with safeguards like timeouts and input sanitization.

Description

PermShell MCP exposes tools for executing shell commands and retrieving system information under the Model Context Protocol, requiring explicit growl-style desktop permission dialogs before running any command. It integrates with LLM toolchains (example config for Claude Desktop is provided) and emphasizes transparency by showing commands with their working directory. Multiple safeguards such as timeouts and input sanitization reduce risk of unauthorized or runaway processes, making it suitable for agents that need auditable, permissioned system interactions.