Provides secure execution of shell commands with permission notifications, allowing system operations with explicit user approval and safeguards against unauthorized usage.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PermShell MCPlist all files in my Downloads folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PermShell MCP
A Model Context Protocol (MCP) server for executing shell commands with permission notifications.
Features
Execute shell commands with explicit permissions through growl notifications
Built on the Model Context Protocol for standardized LLM tools
Multiple safeguards to prevent unauthorized command execution
Transparent permission dialog shows exactly what commands will be executed
Related MCP server: Remote Command MCP Server
Installation
# Clone the repository
git clone https://github.com/yourusername/perm-shell-mcp.git
cd perm-shell-mcp
# Install dependencies
npm install
# Build the project
npm run buildUsage
As a standalone tool
# Start the server directly
npm startWith Claude Desktop
Add the following configuration to your Claude Desktop configuration file:
{
"mcpServers": {
"permshell": {
"command": "node",
"args": ["/path/to/perm-shell-mcp/dist/index.js"]
}
}
}Available Tools
execute-command
Executes a shell command with permission.
Example:
Can you list the files in my home directory?system-info
Retrieves system information including OS, uptime, memory, disk, and CPU.
Example:
What's my system information?Security
All commands require explicit permission through desktop notifications
Commands display with their working directory for full transparency
Timeout limits prevent runaway processes
Input sanitization prevents command injection
Development
# Run in watch mode for development
npm run dev