SSH — policy-gated remote access MCP Server

The risk this server exists to manage. Giving an LLM shell access on a remote host puts private data, untrusted input and network egress in one place — Simon Willison's "lethal trifecta". Prompt…

Local serverstdioMIT

What is the SSH — policy-gated remote access MCP Server?

SSH MCP Server is an MCP project maintained in the tufantunc/ssh-mcp repository. The maintainer describes its purpose as “The risk this server exists to manage. Giving an LLM shell access on a remote host puts private data, untrusted input and network egress in…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using ssh-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares SSH_MCP_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list-connectionsDiscover available hosts and connection status
list-sessionsList active sessions per host
open-sessionCreate a named interactive (stateful) or background session
close-sessionClose a session. A background session's command is signalled (INT/TERM/KILL) before its channel is dropped
read-session-outputRead output from background sessions (e.g., tail -f)
read-commandExecute allowlisted read-only commands (ls, cat, grep, ...)
run-commandExecute arbitrary commands (destructive/privileged need approval, unless approvalPolicy = "auto")
privileged-commandExecute with sudo (needs approval, unless approvalPolicy = "auto")
sftp-uploadUpload a file via SFTP (replaces the destination unconditionally)
sftp-downloadDownload a file via SFTP
sftp-list✅
sftp-upload-fileStream a local file to the remote host, never through model context
sftp-download-fileStream a remote file to local disk, never through model context
signal-processSend INT/TERM/KILL to a remote PID
v1v2
execrun-command
sudo-execprivileged-command

How to install the SSH — policy-gated remote access MCP Server

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "env": {
        "SSH_MCP_PASSWORD": "YOUR_SSH_MCP_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SSH_MCP_PASSWORDDeclared in the maintainer’s client configuration.Check documentation