Securely execute shell commands with whitelisting, resource limits, and timeout controls for LLMs.
Shell command execution MCP server
An MCP server implementation that provides secure shell command execution capabilities for LLMs.
npm install @kevinwatt/shell-mcp
{
"mcpServers": {
"shell": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/shell-mcp"
]
}
}
}
command
(string, required): Command to executeargs
(array, optional): Command argumentstimeout
(number, optional): Execution timeout in msAsk your LLM to:
"Show current directory using shell_pwd"
"List files using shell_ls with -l argument"
"Check disk usage using shell_df with -h argument"
If needed, start the server manually:
npx @kevinwatt/shell-mcp
# Install dependencies
npm install
# Watch mode
npm run watch
# Run tests
npm test
# Lint
npm run lint
MIT © Dewei Yen
The following shell commands are available:
Command | Description | Allowed Arguments |
---|---|---|
ls | List directory contents | -l, -a, -h, -R, --help, * |
cat | Concatenate and display file contents | -n, -b, --help, * |
pwd | Show current working directory | None |
df | Show disk usage | -h, -T, --help |
echo | Display text | Any text |
ps | Show process status | -e, -f, -u, --help |
free | Show memory usage | -h, -m, -g, --help |
uptime | Show system uptime | None |
date | Show system date and time | +%Y-%m-%d, +%H:%M:%S, --help |
grep | Search text patterns in files | -i, -v, -n, -r, -l, --color, * |
w | Show who is logged on and what they are doing | -h, -s, --no-header, --help |
whois | Query WHOIS domain registration information | -H, * |
find | Search for files in a directory hierarchy | -name, -type, -size, -mtime, * |
netstat | Network connection information | -a, -n, -t, -u, -l, -p, --help |
lspci | List PCI devices | -v, -k, -mm, -nn, --help |
lsusb | List USB devices | -v, -t, -d, -s, --help |
dig | DNS lookup utility | +short, +trace, +dnssec, @*, * |
nslookup | Query DNS records | -type=, -query=, * |
ip | Show network devices and interfaces | addr, link, route, neigh, -br, * |
whereis | Locate binary, source and manual files | -b, -m, -s, * |
Interact with the Prefect API for workflow orchestration and management.
A server providing tools for developers working with Starwind UI components.
A platform-agnostic server for scalable mobile automation and development across iOS, Android, simulators, and emulators.
The ultimate open-source server for advanced Gemini API interaction with MCP, intelligently selects models.
Interact with your MLOps and LLMOps pipelines through your ZenML MCP server
A test server for local MCP development and setup.
Provides a sleep/wait tool to add delays between operations, such as waiting between API calls or testing eventually consistent systems.
Refines and structures prompts for large language models using the Anthropic API.
Answers Swift and SwiftUI questions based on the '100 Days of SwiftUI' course using a local SQLite database.
A comprehensive MCP server for managing OPNsense firewalls, offering over 300 tools for configuration and monitoring.