Ssh MCP Server

MCP server for executing shell commands on remote hosts via SSH.

What the server does

Built on somamcp — a functional MCP framework over FastMCP with telemetry, introspection, and backend abstraction.

• Single exec tool — — runs a shell command on the remote host, returns stdout. stderr surfaces as a structured error
• Four auth modes — — password, key file, key from environment variable (e.g. injected by envpkt, Vault, Doppler), or SSH_AUTH_SOCK (system ssh-agent, 1Password, Bitwarden Desktop, KeePassXC)
• Smart path expansion — — --key supports ~, $VAR, ${VAR}, and relative paths via functype-os. Unresolved variables fail fast with a typed error
• OS-user fallback — — --user defaults to the current OS username when omitted
• Fail-fast auth — — the SSH key is loaded and validated at server startup, not on the first exec call
• Introspection out-of-the-box — — soma_health, soma_capabilities, soma_connections auto-registered by somamcp

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.