# ShellGuard MCP server

> Lets LLM agents SSH into remote servers and run validated read-only shell commands for diagnostics, log inspection, and troubleshooting.

- Repository: https://github.com/fawdyinc/shellguard
- Page: https://hostedmcp.org/servers/fawdyinc/shellguard
- Transport: —
- Stars: 29
- License: Apache-2.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SHELLGUARD_SSH_MODE` | no | no |  |

## FAQ

### Does ShellGuard let the AI run any shell command on my server?

No. Every command is parsed, validated against an allowlist with an explicit denylist, and reconstructed, so destructive operations are blocked. Default is deny.

### How does ShellGuard authenticate to remote servers over SSH?

It tries an explicit identity_file first, then ssh-agent, then default keys like ~/.ssh/id_ed25519 and id_rsa, stopping at the first success.

### Which SSH client does ShellGuard use, and does it support ProxyJump?

Native mode uses Go's built-in SSH library by default; system mode uses the local ssh binary for full OpenSSH features including ProxyJump and ProxyCommand.

### What tools does ShellGuard expose to the LLM?

It exposes six tools: connect, execute, disconnect, sleep, provision, and download_file.

### What does the provision tool install on the remote host?

It deploys ripgrep, jq, and yq binaries with SHA-256 verification into ~/.shellguard/bin/ if they are missing.
