Shell MCP Server
by blazickjp
The Shell MCP Server adds secure shell command execution capabilities to AI applications. It is built for the Model Context Protocol.
Last updated: N/A
What is Shell MCP Server?
The Shell MCP Server is a tool that allows AI applications to securely execute shell commands within a controlled environment, adhering to the Model Context Protocol.
How to use Shell MCP Server?
Install the server using pip or uv. Configure your Claude Desktop or other AI application to use the server, specifying allowed directories and shells. Then, use the execute_command function to run commands, specifying the command, shell, and working directory.
Key features of Shell MCP Server
Secure Execution
Multiple Shells
Timeout Control
Cross-Platform
Safe by Default
Use cases of Shell MCP Server
Basic File Operations
Project Management
System Information
File Processing
Windows-Specific Commands
FAQ from Shell MCP Server
What is the default command timeout?
What is the default command timeout?
The default command timeout is 30 seconds, configurable via the COMMAND_TIMEOUT environment variable.
How do I specify allowed directories?
How do I specify allowed directories?
Allowed directories are specified as command-line arguments when starting the server.
What shells are supported?
What shells are supported?
The server supports bash, sh, cmd, and powershell. You can configure additional shells by specifying their name and path as command-line arguments.
How does the server ensure security?
How does the server ensure security?
The server enforces security through directory isolation, shell control, timeout protection, path validation, and permission isolation.
Can I contribute to the project?
Can I contribute to the project?
Yes, contributions are welcome! You can report bugs, suggest features, submit pull requests, and improve documentation.