PermShell MCP

MIT License
1

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
-
security - not tested
-
license - not tested
-
quality - not tested

A Model Context Protocol server that allows LLMs to execute shell commands with explicit user permission through desktop notifications.

  1. Features
    1. Installation
      1. Usage
        1. As a standalone tool
        2. With Claude Desktop
        3. Available Tools
      2. Security
        1. Development

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.
            Last updated -
            Python
          • -
            security
            A
            license
            -
            quality
            A custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.
            Last updated -
            22
            Python
            Apache 2.0
            • Apple
            • Linux
          • -
            security
            A
            license
            -
            quality
            A 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 -
            JavaScript
            MIT License
            • Linux
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that wraps AutoIt functionality, enabling LLMs to automate Windows desktop tasks including mouse/keyboard operations, window management, and UI control interactions.
            Last updated -
            TypeScript
            MIT License

          View all related MCP servers

          ID: csy11vzcl6