Mcp Remote Ssh MCP Server

MCP server giving AI agents full SSH access -- persistent sessions, structured command output, SFTP file transfer, port forwarding, session transcript recording, and secret-safe environment variable…

Local serverstdio

What is the Mcp Remote Ssh MCP Server?

Mcp Remote Ssh is an MCP project maintained in the faizbawa/mcp-remote-ssh repository. The maintainer describes its purpose as “MCP server giving AI agents full SSH access -- persistent sessions, structured command output, SFTP file transfer, port forwarding, session transcript recording, and secret-safe environment…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is mcp-remote-ssh. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

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
ssh_connectConnect with password, key, or agent auth. Optional record=True to start a transcript immediately. Returns session_id
ssh_list_sessionsList active sessions
ssh_close_sessionClose a session and release resources
ssh_executeRun a command, returns {stdout, stderr, exit_code}
ssh_sudo_executeRun with sudo elevation
ssh_shell_openOpen persistent shell (preserves cwd, env, processes)
ssh_shell_sendSend text (with optional Enter)
ssh_shell_readRead current output buffer
ssh_shell_send_controlSend Ctrl+C, Ctrl+D, etc.
ssh_shell_waitWait for a pattern or output to stabilize
ssh_load_env_fileLoad secrets from a local env file; values never returned to the LLM
ssh_clear_secretsClear redaction registry (values become visible again)
ssh_start_recordingStart recording execute/sudo/shell I/O for this session
ssh_stop_recordingStop recording; transcript stays available until the session is closed
ssh_get_transcriptReturn the transcript as text or JSONL (last_n optional)
ssh_save_transcriptWrite the transcript to a local file on the MCP host
ssh_upload_fileUpload local file to remote host
ssh_download_fileDownload remote file to local machine
ssh_read_remote_fileRead a remote text file
ssh_write_remote_fileWrite/append to a remote file
ssh_list_remote_dirList directory with metadata
ssh_forward_portCreate SSH tunnel (local -> remote)
ssh_list_forwardsList active tunnels
ssh_close_forwardClose a tunnel

How to install the Mcp Remote Ssh MCP Server

{
  "mcpServers": {
    "remote-ssh": {
      "command": "uvx",
      "args": [
        "mcp-remote-ssh"
      ]
    }
  }
}

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