Permshell

🚀 Shell Permission MCP Server

A server based on the Model Context Protocol (MCP) for shell command execution with permission notifications.

🚀 Quick Start

The Shell Permission MCP Server is a powerful tool that enables shell command execution with explicit permission notifications. It is built on the Model Context Protocol (MCP), providing a standardized solution for large language model tools.

✨ Features

• Execute shell commands with explicit permissions via -growl notifications.
• Built on the Model Context Protocol to standardize large language model tools.
• Implement multiple protection measures to prevent unauthorized command execution.
• Transparently display specific commands to be executed in the permission dialog.

📦 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 Examples

Basic Usage

Run as a Standalone Tool

# Start the server directly
npm start

Integrate with Claude Desktop

Add the following content to your Claude Desktop configuration file:

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

Advanced Usage

Available Tools

execute-command

Execute shell commands with permissions. Example:

Can you list the files in my home directory?

system-info

Get system information, including operating system, uptime, memory, disk, and CPU details. Example:

What is my system information?

📚 Documentation

Security Tips

• All commands require explicit authorization through desktop notifications.
• Display the working directory for full transparency.
• Implement timeout limits to prevent processes from running indefinitely.
• Purify inputs to prevent command injection attacks.

Development Guide

# Run in development mode
npm run dev