super-shell

Super Shell MCP Server provides a cross-platform interface to execute shell commands via MCP with built-in security features. It automatically detects the host platform (Windows, macOS, Linux) and selects an appropriate shell (cmd.exe or PowerShell on Windows; zsh, bash, or sh on macOS and Linux). Commands are controlled by a whitelist and an optional approval workflow for potentially dangerous operations, reducing the risk of command injection. The server also offers comprehensive logging and command management tools, plus a platform information diagnostic tool to help you troubleshoot environments. Users can interact with the MCP through various clients (e.g., Roo Code, Claude Desktop) using standard MCP server configuration formats.

Prerequisites:

• Node.js and npm installed
• Access to the internet to install npm packages

Option A – Claude Desktop Extension (DXT) recommended:

1. Download the super-shell-mcp.dxt file from the latest release.
2. Open Claude Desktop and install the extension by double-clicking the .dxt file or via Settings > Extensions > Add Extension.
3. Start using immediately; no further configuration required.

Option B – Smithery installation:

1. Run:

npx -y @smithery/cli install @cfdude/super-shell-mcp --client claude

2. Follow prompts to complete installation.

Option C – Manual installation:

1. Clone the repository and install dependencies:

git clone https://github.com/cfdude/super-shell-mcp.git
cd super-shell-mcp
npm install

2. Build the project (if required by the repo):

npm run build

3. Start the server:

npm start

4. If running manually, you can also start with the built index:

node build/index.js

Notes:

• The MCP configuration supports NPX-based usage as shown in the example configuration.
• Ensure network and security guidelines are followed when enabling command execution on client machines.

Tips and considerations:

• Shell parsing is disabled by default for security; enable via the SUPER_SHELL_USE_SHELL environment variable only for trusted workflows.
• If you enable shell parsing, you may need to provide CUSTOM_SHELL with the path to the desired shell executable.
• The default command timeout is 30 seconds; override with SUPER_SHELL_COMMAND_TIMEOUT as needed.
• Placing trusted shells and whitelists per platform helps minimize risk.
• On Windows, examples show paths to cmd.exe and PowerShell; on macOS/Linux, common shells include /bin/zsh, /bin/bash, and /bin/sh.
• For Claude Desktop users, the DXT extension generally handles startup and platform detection automatically.
• If you run into issues, check the log files in the server’s log directory and verify environment variable values are correctly set.