Skip to main content
Glama
remote-ssh-mcp
by RuiFG

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
XDG_DATA_HOMENoBase data directory used when REMOTE_SSH_MCP_DATA_DIR is not set. The service defaults to $XDG_DATA_HOME/remote-ssh-mcp.
REMOTE_SSH_MCP_DATA_DIRNoAbsolute path or a path starting with ~/ specifying the data directory for host profiles, known hosts, and credentials. Defaults to $XDG_DATA_HOME/remote-ssh-mcp, or ~/.local/share/remote-ssh-mcp when XDG_DATA_HOME is not set.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Shared persistent SSH hosts. Start with ssh_list_hosts; always use explicit hostId. Supply credentials directly with ssh_add_host or ssh_set_credentials. Never automatically replay a command with unknown outcome. Local transfer paths resolve against the MCP server startup directory; prefer absolute paths.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
ssh_list_hostsA

List configured SSH hosts with stable IDs, connection status and this session's per-host working directories. Never returns credentials. All other SSH tools require an explicit hostId; there is no default host.

ssh_set_workspaceA

Connect or explicitly reconnect one host and set its remote working directory after validation. First connection starts at the login home. Omitting path keeps the current directory. Does not affect other hosts.

ssh_shell_execA

Execute a command in this host's working directory. Returns stdout, stderr, exitCode and outcome. Default timeout is 120 seconds; 0 disables it. sudo:true runs the entire command as root without an approval dialog; set sudo credentials with ssh_set_credentials when required. Never include passwords in command or stdin. Temporary cd does not change the stored directory. Never replay an unknown outcome automatically.

ssh_read_fileA

Read a remote text file through SFTP with 1-based startLine and bounded output. Use ssh_download_file for binary data.

ssh_write_fileA

Write remote UTF-8 text via SFTP using a temporary file. Requires an existing parent directory and explicit overwrite:true to replace a file.

ssh_grepB

Search remote file content under a directory using the server's existing grep extended regular expressions. Optional include filters filenames. Output is bounded; no helper is installed remotely.

ssh_globB

Find relative paths through SFTP using glob patterns, including **. Does not recurse into directory symlinks. Results and traversal are bounded.

ssh_upload_fileB

Stream one local file, including binary data, to an exact remote path via SFTP. Local paths are relative to the MCP server startup directory. Transfers directly without a confirmation dialog. overwrite defaults to false.

ssh_download_fileA

Stream one remote file to an exact local path via SFTP. Local paths are relative to the MCP server startup directory. Transfers directly without a confirmation dialog. overwrite defaults to false.

ssh_reset_connectionA

Reset this session's connection to one host and revalidate its directory. Does not replay commands or guarantee termination of remote processes. Manually disconnected hosts require ssh_set_workspace instead.

ssh_add_hostA

Persist a new uniquely named SSH host shared by Codex and Claude. For password auth provide credential; for key auth provide privateKeyPath and optional credential passphrase. Credentials are remembered by default; remember:false uses this MCP connection only. Returns stable ID and version. No interactive dialog.

ssh_update_hostA

Update host fields with optimistic version checking. Null clears a jump host or private-key path. Connection identity changes clear saved login/sudo credentials to prevent reuse on a different endpoint; set credentials again. Existing connections require ssh_reset_connection. Rename preserves the ID.

ssh_delete_hostA

Delete a host and its credentials using expectedVersion. New operations in all clients fail afterward; already-started commands are not forcibly interrupted. Referenced jump hosts cannot be deleted. cleanupPending:true means credential cleanup must be retried by a later management operation.

ssh_test_connectionA

Test SSH and SFTP with a temporary connection. Does not change this MCP connection's workspace or working SSH connection. Missing credentials fail immediately; set them with ssh_set_credentials.

ssh_set_credentialsA

Set login or sudo credential, remembered by default and shared across clients. remember:false overlays it only for this MCP connection without deleting saved credentials. For sudo explicitly provide credential OR reuseSshPassword:true. Login credential changes require ssh_reset_connection for existing connections. Returns the latest host version; never returns secret values.

ssh_forget_host_keyA

Explicitly forget this host endpoint's trusted SSH fingerprint after independently verifying its identity. Next fresh connection records a new fingerprint. Existing connections are not retroactively reverified; reset them explicitly. Never use automatically to bypass a fingerprint mismatch.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 16 tools

Disambiguation4/5

Each tool targets a distinct resource+action (host CRUD, connection lifecycle, exec, SFTP read/write/transfer, search), and the descriptions explicitly clarify boundaries such as set_workspace vs reset_connection and read_file (UTF-8 text) vs download_file (binary stream). Minor residual overlap exists between ssh_write_file and ssh_upload_file for text files, and between ssh_set_workspace and ssh_reset_connection, both of which reconnect a host.

Naming Consistency4/5

All 16 tools share a uniform ssh_ prefix with snake_case and are predominantly verb_noun (ssh_list_hosts, ssh_add_host, ssh_read_file, ssh_download_file). A few deviate from verb_noun — ssh_grep, ssh_glob, and ssh_shell_exec are verb-only or noun+verb — but the pattern remains highly predictable.

Tool Count4/5

16 tools is on the heavy side but each earns its place: 6 host-management tools, 4 connection/credential lifecycle tools, 1 exec, and 5 file/search tools. Nothing looks redundant or padded, though the surface is broad enough to be slightly above the ideal sweet spot.

Completeness4/5

The surface covers host CRUD with versioning, connection reset/reconnect, credential and host-key management, command execution, text read/write, binary upload/download, and grep/glob search — a full lifecycle for remote SSH work. Gaps are minor: no remote mkdir/remove/stat or directory-listing tool, though these are reachable through ssh_shell_exec and ssh_glob.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues