Super Shell MCP Server
About
An MCP server that securely executes shell commands across Windows, macOS, and Linux. It provides automatic platform detection, multiple shell support, and built-in command whitelisting with approval workflows. Designed for use with Claude Desktop (one-click extension available)…
Details
- Author
- cfdude
- GitHub stars
- 18
- Downloads
- 547
- Categories
- Developer Tools
Jump to
- Cross-platform support: Windows, macOS, and Linux
- Automatic platform detection and shell selection
- Command whitelisting with Safe, Requires Approval, and Forbidden levels
- Shell parsing disabled by default to prevent command injection
- Non-blocking approval workflow for dangerous commands
- Comprehensive logging and command management tools
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Super Shell MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via the Claude Desktop Extension (.dxt) for one-click setup, or use Smithery (npx -y @smithery/cli install @cfdude/super-shell-mcp --client claude), or clone the repository and run npm install && npm run build. For manual MCP client configuration, the recommended method uses NPX (npx -y super-shell-mcp). Configure environment variables like CUSTOM_SHELL or SUPER_SHELL_USE_SHELL as needed.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"super shell mcp server": {
"super-shell-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@cfdude/super-shell-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"super-shell-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@cfdude/super-shell-mcp",
"--client",
"claude"
]
}
}Super Shell MCP Server
An MCP (Model Context Protocol) server for executing shell commands across multiple platforms (Windows, macOS, Linux). This server provides a secure way to execute shell commands with built-in whitelisting and approval mechanisms.
> 🎉 Now available as a Claude Desktop Extension! Install with one click using the .dxt package - no developer tools or configuration required.
Features
- Execute shell commands through MCP on Windows, macOS, and Linux
- Automatic platform detection and shell selection
- Support for multiple shells:
- Windows: cmd.exe, PowerShell
- macOS: zsh, bash, sh
- Linux: bash, sh, zsh
- Shell parsing disabled by default to eliminate command-injection risk, with an explicit opt-in mode for trusted workflows
- Command whitelisting with security levels:
- Safe: Commands that can be executed without approval
- Requires Approval: Commands that need explicit approval before execution
- Forbidden: Commands that are explicitly blocked
- Platform-specific command whitelists
- Non-blocking approval workflow for potentially dangerous commands
- Comprehensive logging system with file-based logs
- Comprehensive command management tools
- Platform information tool for diagnostics
Installation
Option 1: Claude Desktop Extension (.dxt) - Recommended
One-Click Installation for Claude Desktop:
1. Download the super-shell-mcp.dxt file from the latest release
2. Quick Install: Double-click the .dxt file while Claude Desktop is open
OR
Manual Install:
- Open Claude Desktop
- Go to Settings > Extensions
- Click "Add Extension"
- Select the downloaded super-shell-mcp.dxt file
3. Configure (optional): Set custom shell path if needed
4. Start using - The extension is ready to use immediately!
✅ Benefits of DXT Installation:
- No developer tools required (Node.js, Python, etc.)
- No manual configuration files
- Automatic dependency management
- One-click installation and updates
- Secure credential storage in OS keychain
Option 2: Installing via Smithery
To install Super Shell MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @cfdude/super-shell-mcp --client claude
Option 3: Installing Manually
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
