Super Shell

Super Shell MCP

javascript

13

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cfdude-super-shell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "super-shell-mcp"
      ],
      "env": {
        "CUSTOM_SHELL": "/bin/bash",
        "SUPER_SHELL_USE_SHELL": "true",
        "SUPER_SHELL_COMMAND_TIMEOUT": "30000"
      }
    }
  }
}

You have a secure MCP server that lets you execute shell commands across Windows, macOS, and Linux with built‑in whitelisting and an approval workflow. It detects your platform, chooses the right shell, and enforces security to keep your environment safe while enabling automation and integration with your MCP clients.

How to use

Install the MCP client on your workflow environment (Roo Code, Claude Desktop, or any compatible client). The server exposes a set of tools you can call to manage the whitelist, run commands, and handle approvals. Start by querying platform info to confirm the detected platform and shell, then execute approved commands or route potentially dangerous requests through the approval queue.

How to install

Prerequisites you need before installation:

Node.js and npm/yarn installed on your system
Access to a terminal or shell
A compatible MCP client to connect to the server

Choose your installation method and follow the steps below.

Option 1. Claude Desktop Extension (.dxt) — Recommended: one‑click install from Claude Desktop, or manual install via Settings under Extensions, then add the downloaded super-shell-mcp.dxt file. No developer tools required.

Option 2. Install via Smithery: you can install and run the server through the Smithery client without manual setup.

Option 3. Manual installation: clone the repository, install dependencies, and build the project.

# Option 2: Smithery
npx -y @smithery/cli install @cfdude/super-shell-mcp --client claude

# Option 3: Manual installation
# Clone and set up locally
# git clone https://github.com/cfdude/super-shell-mcp.git
# cd super-shell-mcp
# npm install
# npm run build

Configure the MCP client for local or remote operation

You can run the MCP server locally or connect to a remote MCP endpoint when using an MCP client. The following NDJSON-like configurations show how the client can invoke the server via NPX in a typical setup.

"super-shell": {
  "command": "npx",
  "args": ["-y", "super-shell-mcp"],
  "alwaysAllow": [],
  "disabled": false
}

Available tools

get_platform_info

Get information about the current platform and shell.

execute_command

Execute a shell command on the current platform.

get_whitelist

Get the list of whitelisted commands.

add_to_whitelist

Add a command to the whitelist with a security level.

update_security_level

Update the security level of a whitelisted command.

remove_from_whitelist

Remove a command from the whitelist.

get_pending_commands

Get the list of commands pending approval.

approve_command

Approve a pending command.

deny_command

Deny a pending command.