tumf / mcp-shell-server
Secure MCP server for whitelisted shell command execution with stdin, argv pipelines, timeouts, and structured audit logging.
Why this job: name: mcp; says: mcp server; topics: model-context-protocol, mcp
What it does
- Argv-based Command Execution. Allowed commands run via subprocess argv without shell-string interpretation
- Standard Input Support. Pass input to commands via stdin
- Comprehensive Output. Returns stdout, stderr, exit status, and execution time
- Safe Pipeline Support. Pipelines preserve and validate argv segments instead of invoking a shell
- Execution Limits. Server-side default timeout, maximum timeout, and output byte caps are enforced
Get started
npx -y @smithery/cli install mcp-shell-server --client claude You need: Python 3.11 or higher; mcp>=1.1.0
- Maintenance
- Active
- Last commit 11 days ago
- Stars
- 201
- On GitHub
- Licence
- MIT
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v1.1.14
- Released 21 days ago
- Built with
- Python
- 99% of the code
Is it looked after?
- Contributors
- 3
- Last 90 days
- Issues
- 67% closed
- 5 still open
- Pull requests
- 30 merged
- 1 waiting
- Releases
- 18
- 16 in the last year
- No contributing guide
- Security policy (opens in new tab)
- No code of conduct
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| bvisible / mcp-ssh-manager | 535 | 4 days ago | MIT | Mac, Windows, Linux |
| sonirico / mcp-shell | 111 | 45 days ago | GPL-3.0 | No downloads |
More: languages, topics and project record
Languages
- Python 99%
- Shell <1%
- Makefile <1%
- Dockerfile <1%
Topics
- audit-log
- command-whitelist
- mcp
- model-context-protocol
- security
- shell
Project record
- JobMCP servers
- StatusListed
- Commits373
- Forks51
- Watching2
- Stars in 28 days0
- CreatedDec 10, 2024
- First seen by usNov 7, 2026
- CheckedNov 7, 2026