Shell Command MCP

Example Use Cases

• 1

  List and inspect files or directories on a host (e.g., using shell_ls, shell_pwd, shell_find) while ensuring only allowed flags are used.

• 2

  Collect system status and diagnostics such as disk usage, memory usage, process lists, uptime, and hardware/network info (e.g., shell_df, shell_free, shell_ps, lspci, netstat).

• 3

  Perform safe network or lookup operations like DNS queries and WHOIS lookups (e.g., dig, nslookup, whois) with controlled arguments and execution limits.

Description

shell-mcp provides an MCP-compatible server that enables language models to run approved shell commands and arguments while enforcing safety constraints. It includes whitelisting of commands, CPU/memory monitoring, execution timeouts, and output size limits to reduce risk. The project is distributed as an npm package and integrates with MCP clients such as Dive Desktop and Claude.

Capabilities(20 total)