sonirico/mcp-shell

View on GitHub ↗

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

96 ★18 forksGoUpdated 19d ago

What you need to know

Shell command-execution MCP server in Go with a safe-mode whitelist of read-only tools

Install

Go build or Docker

Usage

  • •Default safe mode only exposes whitelisted read-only tools; YAML policy config

Key features

  • ✓safe-mode whitelist
  • ✓YAML policies
  • ✓full shell only with MCP_SHELL_ALLOW_UNSAFE=true

Best for

Scripted tasks with a safety gate

Caveats

  • ⚠Unsafe full shell requires explicit env opt-in
Platforms: Docker · GoClients: Claude · Codex

Reviewed 2026-08-11

Topics

aibashgollmmcpmodel-context-protocolos-execshellterminal
Stars
96★
Forks
18
Language
Go
License
GPL-3.0
Created
2025-05-24
Last push
2026-08-16