README.md
Shell MCP Server
MCP (Model Context Protocol) server for safe shell command execution.
Features
- 🔒 Security - Restricted to workspace directory
- ⏱️ Timeout enforcement - Prevents hanging commands
- 📝 Command history - Track all executed commands
- 📦 Environment isolation - Controlled env vars
- 📊 Output limits - Prevent memory issues
Tools
execute
Execute a shell command with safety controls.
{
"command": "ls -la",
"cwd": "/root/.openclaw/workspace",
"timeout": 30000,
"env": { "MY_VAR": "value" }
}
Parameters:
command(required) - Command to executecwd- Working directory (default: /root/.openclaw/workspace)timeout- Timeout in ms (default: 30000, max: 120000)env- Environment variables object
history
Get command execution history.
{
"limit": 50
}
clearHistory
Clear command history.
{}
Usage
Direct
cd /root/.openclaw/workspace/shell-mcp-server
npm start
With MCP config (mcporter)
{
"type": "stdio",
"command": "node",
"args": ["/root/.openclaw/workspace/shell-mcp-server/index.js"]
}
With Claude Code CLI
claude --mcp-config shell-mcp-server.json
Install
cd /root/.openclaw/workspace/shell-mcp-server
npm install
Test
npm test
Security Notes
- Commands are restricted to
/root/.openclaw/workspaceand subdirectories - Output is limited to 1MB per command
- Maximum timeout is 2 minutes
- History is saved to
.shell-history.json
Tools 3
executeExecute a shell command with safety controls.historyGet command execution history.clearHistoryClear command history.Try it
→List all files in the current directory to see what I'm working with.
→Run a grep search for 'TODO' in the current workspace directory.
→Show me the last 10 commands I executed using the shell server.
→Clear my command execution history.