{"repo":"sonirico/mcp-shell","free":true,"listed":false,"github":"https://github.com/sonirico/mcp-shell","clone":"git clone https://github.com/sonirico/mcp-shell.git","description":"Give hands to AI. MCP server to run shell commands securely, auditably, and on demand.","language":"Go","stars":96,"topics":["ai","bash","go","llm","mcp","model-context-protocol","os-exec","shell","terminal"],"license":"GPL-3.0","category":"mcp-servers","readme_excerpt":"mcp-shell MCP server that runs shell commands. Your LLM gets a tool; you get control over what runs and how. Built on mark3labs/mcp-go. Written in Go. --- Run it Docker (easiest): From source : --- Configure it Secure mode is the default. With no config file, mcp-shell boots in secure mode restricted to a narrow allowlist of read-only utilities ( ls , cat , grep , find , head , tail , ...). You only need a config file to widen or change that policy. To run fully unrestricted you must opt in explicitly: To customize the policy, point to a YAML config: Secure mode (recommended) — no shell interpretation, executable allowlist only: Legacy mode — shell execution, allowlist/blocklist by command string (vulnerable to injection if not careful): --- Wire it up Claude Desktop — add to your MCP config: For custom config, mount the file and set the env: --- Tool API Parameter Type Description ----------- ------ ------------- command string Shell command to run (required) base64 boolean Encode stdout/stderr as base64 (default: false) Response includes status , exit code , stdout , stderr , command , execution time , and optional security info . --- Environment variables Variable Description ---------- ------------- MCP SHELL SEC CONFIG FILE Path to security YAML (overrides built-in secure defaults) MCP SHELL ALLOW UNSAFE Set true to disable all validation and run unrestricted (opt-in) MCP SHELL SERVER NAME Server name (default: \"mcp-shell 🐚\") MCP SHELL LOG LEVEL debug, info, warn, error","default_branch":null,"files":null,"tree":[],"storefront":"/r/sonirico","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/sonirico/mcp-shell/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}