| name | bridge |
| version | 1.19.1 |
| description | Use when the user wants to run a command on or manage a remote host over SSH —
a server, Raspberry Pi, VM, NAS, network switch, or air-gapped machine.
Triggers: "check/manage my server", "run X on host Y", "ssh into / exec on
host", "restart nginx on prod", "docker ps / containers on", "kubectl / k8s
pods / helm on the cluster", "tail the logs on", "disk usage / cpu / memory /
processes on host", "what's listening on port", "is host reachable", "service
status", "configure / validate the bridge". Drives the bridge-mcp CLI (476 SSH
tools) — guided setup, status checks, and tool execution.
|
| user-invocable | true |
| argument-hint | [status|config|tool-name] [args...] |
SSH Bridge CLI -- Remote Tool Execution
Execute MCP tools on remote hosts or manage bridge configuration via CLI.
Current state
Host status:
!bridge-mcp status 2>/dev/null || echo "bridge-mcp not found -- install with: cargo install --git https://github.com/muchiny/bridge-mcp --features full"
Instructions
No arguments or status
Show host status (above) and available tool groups:
!bridge-mcp list-tools --groups-only
Then ask the user what they want to do.
Config mode
Help the user configure the bridge:
- Config file:
~/.config/bridge-mcp/config.yaml
- Validate:
bridge-mcp validate
- Example config: see https://github.com/muchiny/bridge-mcp/blob/main/config/config.example.yaml
Adding a host:
hosts:
my-server:
hostname: 192.168.1.100
port: 22
user: admin
description: "My server"
auth:
type: key
path: ~/.ssh/id_ed25519
Security modes:
security:
mode: standard
Tool group name (e.g., docker, kubernetes, systemd)
List tools in that group:
!bridge-mcp list-tools --group $ARGUMENTS
Search query
Search tools by keyword:
!bridge-mcp list-tools --search $ARGUMENTS
Tool name with key=value pairs
Execute the tool:
!bridge-mcp --json tool $ARGUMENTS
Workflow reminders
- Verify connectivity with
status before executing tools
- Use
--json output for structured parsing
- Use
--dry-run before destructive operations
- Use
jq_filter or columns params to reduce output tokens