Sshmcp MCP Server

SSH server management with zero-token SFTP file transfer and SOCKS proxy support

Local serverstdioGo

What is the Sshmcp MCP Server?

SSH server management with zero-token SFTP file transfer and SOCKS proxy support

What the server does

All operation tools take a server_id parameter. The connection pool auto-manages connections — no manual connect/disconnect needed:

  • 21 Tools — — Connect, execute, upload, download, write files, and more
  • Connection Pool — — Operate multiple servers simultaneously, each command tagged with server_id
  • Zero-Token File Transfer — — SFTP path-based transfer, file content never enters AI context
  • Directory Upload — — Auto tar.gz compress → upload → remote decompress (fast for many small files)
  • Async Transfer + Progress — — Background transfer for large files with real-time progress tracking
  • Quick Connect — — Temporary connections without saving config, returns host:port as temp ID

Credentials and setup notes

  • Node.js >= 18 - An MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.) - Remote server with SSH access

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.

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_serversList all configured servers and active connections
get_serverView server config details
add_serverAdd/update server config (password, key, agent, OTP)
update_serverModify server config (only pass fields you want to change)
delete_serverRemove a server
rename_serverRename a server ID
connectManually connect (usually not needed, tools auto-connect)
quick_connectTemporary connection, returns host:port as ID
disconnectDisconnect specific server or all connections
test_connectionTest connectivity without affecting existing connections
executeRun shell commands on remote server (with configurable timeout)
read_fileRead remote file content (with optional line range)
write_fileWrite text content to remote file
upload_fileUpload local file to remote (supports async mode)
upload_directoryUpload directory with auto compress → transfer → decompress
download_fileDownload remote file to local (supports async mode)
download_directoryDownload directory with remote compress → transfer → local decompress
transfer_statusCheck progress of async transfers (size/speed/ETA)
list_proxiesList all SOCKS proxy presets
add_proxyAdd SOCKS4/5 proxy preset
delete_proxyRemove a proxy preset

How to install the Sshmcp MCP Server

{
  "mcpServers": {
    "sshmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nl4ever/sshmcp"
      ]
    }
  }
}

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

Configuration

  • Node.js >= 18 - An MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.) - Remote server with SSH access

Frequently asked questions

SSH server management with zero-token SFTP file transfer and SOCKS proxy support Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.