What is MCP Shell?
MCP Shell is a modern, secure CLI tool that implements the Model Context Protocol (MCP) for safe shell command execution. Built with Go for performance and reliability, it provides AI systems with controlled access to system shells across all major platforms.
Key Features
Secure by Design
Built with security best practices, vulnerability scanning, and safe command execution controls.
Highly Configurable
Flexible configuration through CLI flags, environment variables, and configuration files.
Cross-Platform
Works seamlessly on Linux, macOS, Windows, and FreeBSD across multiple architectures.
Quick Installation
Binary Download
Pre-built binaries for all platforms
# Linux
curl -L https://github.com/rafa-dot-el/mcp-shell/releases/latest/\
download/mcp-shell_linux_amd64.tar.gz | tar xz
# macOS
curl -L https://github.com/rafa-dot-el/mcp-shell/releases/latest/\
download/mcp-shell_darwin_amd64.tar.gz | tar xz
# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/rafa-dot-el/mcp-shell/releases/latest/\
download/mcp-shell_windows_amd64.zip -OutFile mcp-shell.zip
Expand-Archive mcp-shell.zipContainer
Run in isolated container environment
# Pull and run
docker pull rafadotel/mcp-shell:latest
docker run -it rafadotel/mcp-shell:latest
# Using podman
podman pull rafadotel/mcp-shell:latest
podman run -it rafadotel/mcp-shell:latestUse Cases
AI System Integration
Provide secure shell access for AI systems that need to execute system commands.
Development Automation
Automate development workflows and build processes through MCP protocol.
System Administration
Safe remote system administration through controlled shell command execution.
Join the Community
MCP Shell is an open source project. We'd love your help to make it better!
Free & Open Source
MCP Shell is licensed under GNU General Public License v3.0 — guaranteeing the four essential freedoms that define Free Software.
1. Freedom to Run
Run the program for any purpose, on any system, without restrictions or permission required.
2. Freedom to Study
Access and study the source code to understand how the program works and adapt it to your needs.
3. Freedom to Share
Redistribute copies to help others, fostering community collaboration and mutual support.
4. Freedom to Improve
Modify the source code and distribute your improvements so the whole community benefits.