mcplist
SH

Shell

Created 4 months ago

A robust Model Context Protocol (MCP) server for secure shell command execution.

Visit Homepage
development documentation public security docker

What is Shell?

Give hands to AI. MCP server to run shell commands securely, auditably, and on demand

Documentation

mcp-shell

Overview

A robust Model Context Protocol (MCP) server that provides secure shell command execution capabilities to AI assistants and other MCP clients.

Features

  • Security First: Configurable command allowlists, blocklists, and execution constraints
  • Docker Ready: Lightweight Alpine-based container for secure isolation
  • Structured Responses: JSON-formatted output with stdout, stderr, exit codes, and execution metadata
  • Binary Data Support: Optional base64 encoding for handling binary command output
  • Performance Monitoring: Execution time tracking and resource limits
  • Audit Logging: Complete command execution audit trail with structured logging
  • Context Aware: Supports command execution with proper context cancellation
  • Environment Configuration: Full configuration via environment variables

Installation

git clone https://github.com/sonirico/mcp-shell
cd mcp-shell
make install

Configuration

Basic server and logging configuration via environment variables.

Security Configuration

Security settings are configured exclusively via YAML configuration file.

License

MIT License - See LICENSE file for details.

Server Config 

{
  "mcpServers": {
    "shell-server": {
      "command": "npx",
      "args": [
        "shell"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: Jul 17, 2025
Updated At: Aug 07, 2025
Author: Sonirico
Category: community
License: MIT License
Tags:
development documentation public