remote-ssh-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SSH_BIN | No | SSH executable path | |
| SSH_HOST | No | Default hostname, alias, or IP address | |
| SSH_PORT | No | SSH TCP port | |
| SSH_USER | No | Username added to SSH_HOST when it has no @ | |
| REMOTE_SSH_BIN | No | Namespaced equivalent of SSH_BIN | |
| REMOTE_SSH_HOST | No | Namespaced equivalent of SSH_HOST | |
| REMOTE_SSH_PORT | No | Namespaced equivalent of SSH_PORT | |
| REMOTE_SSH_USER | No | Namespaced equivalent of SSH_USER | |
| REMOTE_SSH_TIMEOUT_MS | No | Default command timeout | 60000 |
| REMOTE_SSH_MAX_OUTPUT_BYTES | No | Default captured bytes per output stream | 1048576 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| remote_ssh_local_diagnosticsA | Diagnose the local MCP server process and its ability to launch OpenSSH. |
| remote_ssh_checkA | Check that the configured SSH host is reachable and print basic remote identity details. |
| remote_ssh_execA | Run a shell command on the configured SSH host. Reuses your local OpenSSH config and keys. |
| remote_ssh_list_dirA | List a directory on the configured SSH host using ls -la. |
| remote_ssh_read_textA | Read a text file from the configured SSH host. Large files are clipped by maxBytes. |
| remote_ssh_read_file_base64A | Read a file from the configured SSH host as base64. Use this for small binary files. |
| remote_ssh_write_textA | Write UTF-8 text to a file on the configured SSH host through SSH stdin. |
| remote_ssh_write_file_base64A | Decode base64 and write the bytes to a file on the configured SSH host. |
| remote_ssh_start_port_forwardA | Start a local SSH -L tunnel through the configured SSH host. The tunnel stays alive while this MCP server process is alive. |
| remote_ssh_list_port_forwardsA | List SSH tunnels started by this MCP server process. |
| remote_ssh_stop_port_forwardA | Stop a tunnel created by remote_ssh_start_port_forward. |
| remote_ssh_uriA | Return a VS Code Remote-SSH URI and CLI command for the configured SSH host. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct action (check, diagnose, exec, list, read, write, forward, stop, URI). The read/write tools are clearly split by text vs binary, and check vs local_diagnostics separate remote vs local concerns.
Tools follow a consistent remote_ssh_ prefix, but the action part mixes verbs (exec, list, read, write, start, stop) with noun phrases (local_diagnostics, uri). This is a minor inconsistency in an otherwise readable pattern.
12 tools is well-scoped for an SSH remote server, covering connection, diagnostics, command execution, file operations, port forwarding, and URI generation without bloat.
Core remote SSH workflows are covered: connectivity, exec, file read/write (text and binary), directory listing, port forwarding management. Minor gaps like file delete/rename are absent but not critical for typical remote SSH usage.