Perm Shell Mcp
What is Perm Shell Mcp
perm-shell-mcp is a secure MCP server designed for executing shell commands with explicit permission notifications, ensuring safe command execution.
Use cases
Use cases include listing files in directories, retrieving system information, and executing administrative commands with user approval, ensuring security and transparency.
How to use
To use perm-shell-mcp, clone the repository, install dependencies, and start the server. It can be used as a standalone tool or integrated with Claude Desktop by adding specific configurations.
Key features
Key features include executing shell commands with permission notifications, built-in safeguards against unauthorized execution, a transparent permission dialog, and system information retrieval.
Where to use
perm-shell-mcp is suitable for environments where secure command execution is critical, such as development, system administration, and automated tasks requiring user consent.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Perm Shell Mcp
perm-shell-mcp is a secure MCP server designed for executing shell commands with explicit permission notifications, ensuring safe command execution.
Use cases
Use cases include listing files in directories, retrieving system information, and executing administrative commands with user approval, ensuring security and transparency.
How to use
To use perm-shell-mcp, clone the repository, install dependencies, and start the server. It can be used as a standalone tool or integrated with Claude Desktop by adding specific configurations.
Key features
Key features include executing shell commands with permission notifications, built-in safeguards against unauthorized execution, a transparent permission dialog, and system information retrieval.
Where to use
perm-shell-mcp is suitable for environments where secure command execution is critical, such as development, system administration, and automated tasks requiring user consent.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
