Skip to main content
Glama

PermShell MCP

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

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.

  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

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/mcollina/perm-shell-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server