tumf/mcp-shell-server

Overview

A secure shell command execution server implementing the Model Context Protocol (MCP).

Capabilities

• • github integration
• • mcp client integration

Best For

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

Decision Snapshot

• • GitHub stars: 172
• • Forks: 43
• • Source provenance count: 1
• • Active signal: Updated this week from lifecycle signals.
• • Last seen: 4/15/2026
• • Published: 3/17/2026

Installation / Setup

pip install mcp-shell-server

Usage

pytest

Features

• • **Secure Command Execution**: Only whitelisted commands can be executed
• • **Standard Input Support**: Pass input to commands via stdin
• • **Comprehensive Output**: Returns stdout, stderr, exit status, and execution time
• • **Shell Operator Safety**: Validates commands after shell operators (; , &&, ||, |)
• • **Timeout Control**: Set maximum execution time for commands
• • github integration
• • mcp client integration

Use Cases

• • Supports capabilities such as: github integration; mcp client integration.
• • Common usage themes: mcp, curated, markdown-list, awesome-mcp-servers-punkpeye.

Supported Clients / Integrations

• • github integration
• • mcp client integration

Compatibility Signals

• • GitHub: supports (Detected in parser config/capability hints.)

Prompt Examples

Notes / Requirements

• • Primary language: Python
• • License: MIT
• • Parser coverage score: 1.00
• • Source feeds: Awesome MCP Servers (punkpeye)
• • Topic cluster: general

Official Links

• Website
• Repository

Source Information

Related MCP Tools