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
