nikolanddtesla avatar

Sshmcp

nikolanddtesla/ssh-mcp-server

Gives Claude full SSH access to remote servers through 21 tools covering connections, command execution, and file operations. The standout feature is zero-token SFTP transfers that never pass file contents through the AI context, plus background transfers with progress tracking for large files. Handles multiple simultaneous connections through a connection pool, supports jump hosts and SOCKS proxies, and works with passwords, private keys, or ssh-agent. The quick_connect tool lets you spin up temporary connections without saving credentials. Directory uploads auto-compress with tar.gz before transfer. Reach for this when you want Claude to deploy code, manage services, or move files across servers without manually handling SSH sessions yourself.

GitHub stars
10
tools
21
transport
STDIO
last updated
Mar 27, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

list_serversList all configured servers and active connections

List all configured servers and active connections

No parameter schema in public metadata yet.

get_serverView server config details

View server config details

No parameter schema in public metadata yet.

add_serverAdd/update server config (password, key, agent, OTP)

Add/update server config (password, key, agent, OTP)

No parameter schema in public metadata yet.

update_serverModify server config (only pass fields you want to change)

Modify server config (only pass fields you want to change)

No parameter schema in public metadata yet.

delete_serverRemove a server

Remove a server

No parameter schema in public metadata yet.

rename_serverRename a server ID

Rename a server ID

No parameter schema in public metadata yet.

connectManually connect (usually not needed, tools auto-connect)

Manually connect (usually not needed, tools auto-connect)

No parameter schema in public metadata yet.

quick_connectTemporary connection, returns host:port as ID

Temporary connection, returns host:port as ID

No parameter schema in public metadata yet.

disconnectDisconnect specific server or all connections

Disconnect specific server or all connections

No parameter schema in public metadata yet.

test_connectionTest connectivity without affecting existing connections

Test connectivity without affecting existing connections

No parameter schema in public metadata yet.

executeRun shell commands on remote server (with configurable timeout)

Run shell commands on remote server (with configurable timeout)

No parameter schema in public metadata yet.

read_fileRead remote file content (with optional line range)

Read remote file content (with optional line range)

No parameter schema in public metadata yet.

write_fileWrite text content to remote file

Write text content to remote file

No parameter schema in public metadata yet.

upload_fileUpload local file to remote (supports async mode)

Upload local file to remote (supports async mode)

No parameter schema in public metadata yet.

upload_directoryUpload directory with auto compress → transfer → decompress

Upload directory with auto compress → transfer → decompress

No parameter schema in public metadata yet.

download_fileDownload remote file to local (supports async mode)

Download remote file to local (supports async mode)

No parameter schema in public metadata yet.

download_directoryDownload directory with remote compress → transfer → local decompress

Download directory with remote compress → transfer → local decompress

No parameter schema in public metadata yet.

transfer_statusCheck progress of async transfers (size/speed/ETA)

Check progress of async transfers (size/speed/ETA)

No parameter schema in public metadata yet.

list_proxiesList all SOCKS proxy presets

List all SOCKS proxy presets

No parameter schema in public metadata yet.

add_proxyAdd SOCKS4/5 proxy preset

Add SOCKS4/5 proxy preset

No parameter schema in public metadata yet.

delete_proxyRemove a proxy preset

Remove a proxy preset

No parameter schema in public metadata yet.

Sponsors

Readme

@nl4ever/sshmcp

npm version MCP Registry License: MIT

中文文档

Let AI manage your remote servers. A Model Context Protocol (MCP) server that gives AI assistants full SSH access — execute commands, transfer files, manage multiple servers simultaneously, all through natural conversation.

You:   "Deploy the latest build to production server"
AI:    connects → uploads build → restarts service → verifies status

Features


View the full README on GitHub

Details

Repository
github.com/nikolanddtesla/ssh-mcp-server
Package
@nl4ever/sshmcp
Transport
STDIO
Registry
MCP registry, active