mcp-shell
33
Shell MCP Server is a secure Node.js-based implementation of the Model Context Protocol that facilitates safe shell command execution. It integrates with Claude Desktop and provides robust security features like command blacklisting and validation.
Shell MCP Server
A Node.js implementation of the Model Context Protocol (MCP) that provides secure shell command execution capabilities.
Features
- MCP-compliant server implementation
- Secure command execution with blacklist protection
- Command existence validation
- Standard I/O based transport
- Error handling and graceful shutdown
Installation
Run the package to set up the server and configure it for integration with Claude Desktop.
Security Features
- Command Blacklisting to prevent dangerous command execution
- Command Validation to ensure safety and return clear errors
Available Tools
- run_command: Executes a shell command and returns its output.
Blacklisted Commands
Categories including file system destruction, disk/filesystem, and privilege escalation commands are blocked.
Error Handling
Comprehensive error handling for various command and protocol errors.
Implementation Details
Built using Model Context Protocol SDK, StdioServerTransport, execa, and command-exists.