Executes shell commands inside specified directories with directory isolation and timeouts, supporting bash, sh, cmd and PowerShell.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add shell -- uv pip install shell-mcp-server~/.codex/config.toml
[mcp_servers.shell]
command = "uv"
args = ["pip", "install", "shell-mcp-server"]
# codex mcp add shell -- uv pip install shell-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"shell": {
"command": "uv",
"args": [
"pip",
"install",
"shell-mcp-server"
]
}
}
}.vscode/mcp.json
{
"servers": {
"shell": {
"type": "stdio",
"command": "uv",
"args": [
"pip",
"install",
"shell-mcp-server"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"shell": {
"command": "uv",
"args": [
"pip",
"install",
"shell-mcp-server"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"shell": {
"command": "uv",
"args": [
"pip",
"install",
"shell-mcp-server"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"shell": {
"command": "uv",
"args": [
"pip",
"install",
"shell-mcp-server"
]
}
}
}