PermShell MCP

Execute shell commands with permission notifications.

GitHub

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

Máy chủ liên quan

NotebookLM Web Importer

Nhập trang web và video YouTube vào NotebookLM chỉ với một cú nhấp. Được tin dùng bởi hơn 200.000 người dùng.

Cài đặt tiện ích Chrome