Skip to content
MCP KB

Server: ssh

Overview

Section titled “Overview”

SSH MCP server gives the agent controlled SSH access (run commands, upload/download files, batch execution).

SSoT: unified-mcp-system/configs/servers/core.yaml (ssh)

Install / run

Section titled “Install / run”
  • Command: pnpm
  • Args: ["dlx","-y","@aiondadotcom/mcp-ssh@1.1.0"]

Requirements

Section titled “Requirements”
  • Working ~/.ssh/config and keys on the machine running the MCP server.

Security

Section titled “Security”
  • Prefer host aliases from ~/.ssh/config (don’t hardcode IPs in MCP configs).
  • Use least-privilege accounts; avoid password auth.

Troubleshooting

Section titled “Troubleshooting”
  • “Permission denied”: check key + ssh -v <hostAlias> locally.
  • “Host not found”: ensure host exists in ~/.ssh/config or known_hosts.