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 — ensuring software freedom for everyone, forever.
Transparent
Open source code you can inspect and verify
Collaborative
Community-driven development and contributions
Freedom
Use, modify, and distribute without restrictions
Copyleft
GPL3 ensures derivatives stay free