add_proxy
Add or update SOCKS proxy preset
LABSCO SUMMARY
Saved servers, remote command execution, and file transfers run from one place, with large transfers handled asynchronously.
The 21 tools cover connection management, remote execution, and transfers; upload and download support an async mode with transfer_status for progress on large files and directories. quick_connect opens a temporary, unsaved connection and returns a host:port to use as the server ID.
What it is
An SSH management server: its 21 tools store server and proxy configurations, open connections, run remote commands, read and write remote files, and transfer files and directories in both directions.
What you get
- Save, update, and list server and SOCKS-proxy configurations (add_server, update_server, list_servers, add_proxy)
- Open, test, and close connections, including temporary ones (connect, quick_connect, test_connection, disconnect)
- Run remote shell commands and read or write remote files (execute, read_file, write_file)
- Upload and download files and directories, with async transfers for large ones (upload_file, download_directory, transfer_status)
Requirements
SSH access to the target servers — hosts, ports, and credentials or keys.
Setup effort
One command — npx -y @nl4ever/sshmcp
USE CASES
01
Running a command on a remote server
Connect to a saved server and execute a shell command on it.
02
Editing a config file on a server
Read a remote file over a line range, then write the change back.
03
Moving a large directory to a server
Upload a directory as an async transfer and poll its progress.
04
Connecting to a one-off host without saving it
Open a temporary connection and use the returned ID for follow-up operations.
21 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_server
Add or update server configuration
connect
Manually connect to server (usually not needed, tools auto-connect)
delete_proxy
Delete proxy preset
delete_server
Delete server configuration
disconnect
Disconnect from server
download_directory
Download remote directory (remote compress → download → local extract. Use async for large dirs)
download_file
Download file from remote server (use async mode for large files)
execute
Execute shell command on remote server
get_server
View server configuration details
list_proxies
List all configured SOCKS proxies
list_servers
List all configured servers and active connections
quick_connect
Temporary server connection (not saved). Returns host:port as server_id for subsequent operations
read_file
Read remote file content (supports line range, suitable for logs and config files)
rename_server
Rename server ID (alias)
test_connection
Test server connectivity (does not affect existing connections)
transfer_status
Check background transfer task progress (use with async_transfer=true)
update_server
Update server configuration (only pass fields to change, rest unchanged)
upload_directory
Upload local directory to remote server (auto compress, transfer, and extract. Use async for large dirs)
upload_file
Upload local file to remote server (path-based, zero token cost. Use async mode for large files)
write_file
Write content to remote file (overwrite)
BEFORE YOU INSTALL
What to know first
Tools you get
21 tools when we connected.
Requires
- npx on PATH
- Node.js >= 18
CONTEXT COST
Light Standing cost
Rated by the size of the 21 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"sshmcp": {
"command": "npx",
"args": [
"-y",
"@nl4ever/sshmcp"
]
}
}
}npx
TERMINAL
npx -y @nl4ever/sshmcp
