Shell MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 startWith 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.jsonInstall
cd /root/.openclaw/workspace/shell-mcp-server
npm installTest
npm testSecurity Notes
Commands are restricted to
/root/.openclaw/workspaceand subdirectoriesOutput is limited to 1MB per command
Maximum timeout is 2 minutes
History is saved to
.shell-history.json
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
I run shell commands on your private cloud environment (bash, sh, zsh)
Execute PowerShell commands securely with controlled timeouts and input validation. Retrieve syste…
Secure Linux sandboxes for AI agents, as MCP tools.
Run AI agent tasks in isolated sandboxes with a cost cap, saved workflows and scoped connections.