shell-mcp-server
10
Shell MCP Server provides secure shell command execution for AI applications, featuring cross-platform support and multiple shells. It ensures security through directory isolation and permission management, embodying the Model Context Protocol.
🖥️ Shell MCP Server
🚀 Add secure shell command execution capabilities to your AI applications with the Shell MCP Server! Built for the Model Context Protocol.
✨ Features
- 🔒 Secure Execution - Commands run only in specified directories
- 🐚 Multiple Shells - Support for bash, sh, cmd, powershell
- ⏱️ Timeout Control - Automatic termination of long-running commands
- 🌍 Cross-Platform - Works on both Unix and Windows systems
- 🛡️ Safe by Default - Built-in directory and shell validation
⚙️ Configuration
| Argument | Description |
|---|---|
directories | 📁 List of allowed directories |
--shell name path | 🐚 Shell specifications (name and path) |
Environment variables:
COMMAND_TIMEOUT: ⏱️ Max execution time in seconds (default: 30)
🛡️ Security Features
- 🔐 Directory Isolation: Commands can only execute in specified directories
- 🔒 Shell Control: Only configured shells are allowed
- ⏰ Timeout Protection: All commands have a configurable timeout
- 🛑 Path Validation: Working directory validation prevents traversal attacks
- 👤 Permission Isolation: Commands run with the same permissions as the server process
🤝 Contributing
Contributions are welcome! Feel free to:
- 🐛 Report bugs
- 💡 Suggest features
- 🔧 Submit pull requests
- 📚 Improve documentation
📜 License
MIT License - see LICENSE for details.