super-shell-mcp

super-shell-mcp

5
os_automation

Super Shell MCP Server is an MCP server designed to securely execute shell commands across multiple platforms including Windows, macOS, and Linux. It features automatic platform detection, command whitelisting, and non-blocking workflows for executing commands securely. The server supports comprehensive logging and command management tools, enhancing security and operational efficiency.

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.

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
  • Command whitelisting with security levels: Safe, Requires Approval, Forbidden
  • Platform-specific command whitelists
  • Non-blocking approval workflow
  • Comprehensive logging system

Installation

  • Installing via Smithery
  • Manually: clone repository, install dependencies, build project

Usage

  • Starting the Server
  • Configuring in Roo Code and Claude Desktop

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

Security Considerations

  • Commands executed with user permissions
  • Commands requiring approval held in queue
  • Forbidden commands never executed