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