-
securityF
license-
qualityA Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.
Last updated -
3
Provides secure execution of shell commands with permission notifications, allowing system operations with explicit user approval and safeguards against unauthorized usage.
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
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 build
Usage
As a standalone tool
# Start the server directly
npm start
With 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
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that allows LLMs to execute shell commands with explicit user permission through desktop notifications.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables remote execution of shell commands across different operating systems, automatically handling platform-specific differences between Windows and Unix-like systems.Last updated -1MIT License
- -securityFlicense-qualityA secure interface that enables language models to execute shell commands on the host operating system through the Model Context Protocol.Last updated -1
- AsecurityFlicenseAqualityA local Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH connections.Last updated -612