@nl4ever/sshmcp

中文文档

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

• 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
• SOCKS4/5 Proxy — Per-connection proxy support
• Jump Host — SSH ProxyJump for bastion/gateway access
• Multi-Auth — Password, private key, ssh-agent, keyboard-interactive (OTP/2FA)

Quick Start

Install globally

npm install -g @nl4ever/sshmcp

Add to Claude Code

claude mcp add sshmcp sshmcp

Add to Claude Desktop

Edit claude_desktop_config.json:

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

Add to Cursor

Go to Settings → MCP Servers → Add:

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

Tools Overview

Connection Management

Tool	Description
list_servers	List all configured servers and active connections
get_server	View server config details
add_server	Add/update server config (password, key, agent, OTP)
update_server	Modify server config (only pass fields you want to change)
delete_server	Remove a server
rename_server	Rename a server ID
connect	Manually connect (usually not needed, tools auto-connect)
quick_connect	Temporary connection, returns host:port as ID
disconnect	Disconnect specific server or all connections
test_connection	Test connectivity without affecting existing connections

Command Execution

Tool	Description
execute	Run shell commands on remote server (with configurable timeout)

File Operations

Tool	Description
read_file	Read remote file content (with optional line range)
write_file	Write text content to remote file
upload_file	Upload local file to remote (supports async mode)
upload_directory	Upload directory with auto compress → transfer → decompress
download_file	Download remote file to local (supports async mode)
download_directory	Download directory with remote compress → transfer → local decompress
transfer_status	Check progress of async transfers (size/speed/ETA)

Proxy Management

Tool	Description
list_proxies	List all SOCKS proxy presets
add_proxy	Add SOCKS4/5 proxy preset
delete_proxy	Remove a proxy preset

Connection Pool: Multi-Server Operations

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

AI: execute(server_id="prod", command="nginx -s reload")         ← auto-connects to prod
AI: execute(server_id="dev", command="tail -f /var/log/app.log")

... [View full README on GitHub](https://github.com/NikolaNddTesla/ssh-mcp-server#readme)