Sshmcp

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (21)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Sshmcp.

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

Documentation Overview

@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.

Code

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

Terminal

npm install -g @nl4ever/sshmcp

Add to Claude Code

Terminal

claude mcp add sshmcp sshmcp

Add to Claude Desktop

Edit claude_desktop_config.json:

config.json

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

Add to Cursor

Go to Settings → MCP Servers → Add:

config.json

{
  "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:

Code

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") ← auto-connects to dev, prod stays
AI: execute(server_id="prod", command="curl localhost")           ← reuses prod connection

For temporary servers, use quick_connect which returns host:port as the ID:

Code

AI: quick_connect(host="1.2.3.4", username="root", password="***")
→ "Connected: root@1.2.3.4:22, use server_id="1.2.3.4:22""

AI: execute(server_id="1.2.3.4:22", command="df -h")
AI: disconnect(server_id="1.2.3.4:22")

Async Transfer (Large Files)

For large files, enable background transfer mode to avoid blocking:

Code

AI: upload_file(server_id="prod", local_path="big.tar.gz", remote_path="/data/", async_transfer=true)
→ "Background upload started: tf_1"

AI: transfer_status("tf_1")
→ "🔄 Uploading: 638.2 MB / 1.2 GB (53.2%) — 12.4 MB/s, ETA 46s"

AI: transfer_status("tf_1")
→ "✅ Upload complete: 1.2 GB, 98s, 12.3 MB/s"

Small files use synchronous mode by default — no config needed.

Connection Examples

Password authentication

Code

AI: add_server(server_id="prod", name="Production", host="10.0.0.1", username="deploy", password="***")
AI: execute(server_id="prod", command="systemctl status nginx")

Private key authentication

Code

AI: add_server(server_id="aws", name="AWS EC2", host="ec2-xx.compute.amazonaws.com", username="ubuntu", private_key="~/.ssh/id_rsa")

Quick connect (no config saved)

Code

AI: quick_connect(host="192.168.1.100", username="root", password="***")
→ server_id="192.168.1.100:22"

AI: execute(server_id="192.168.1.100:22", command="df -h")
AI: disconnect(server_id="192.168.1.100:22")

Via SOCKS5 proxy

Code

AI: add_proxy(proxy_id="tunnel", name="SSH Tunnel", host="127.0.0.1", port=1080, type="5")
AI: add_server(server_id="internal", ..., proxy="tunnel")

Via jump host

Code

AI: add_server(server_id="bastion", name="Bastion", host="bastion.example.com", username="admin", private_key="~/.ssh/id_rsa")
AI: add_server(server_id="internal", name="Internal DB", host="10.0.0.5", username="dbadmin", password="***", jump_host="bastion")

Config Location

Server and proxy configurations are stored in:

Code

~/.ssh-mcp/config.json

Passwords are stored in plaintext. For production use, prefer private key authentication.

Requirements

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

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

438

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Sshmcp

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "sshmcp": { "command": "npx", "args": ["-y","@nl4ever/sshmcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/sshmcp?style=directory)](https://allmcps.com/mcp/sshmcp)

HTML Embed

<a href="https://allmcps.com/mcp/sshmcp"><img src="https://allmcps.com/api/badge/sshmcp?style=directory" alt="Sshmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

3/5 checks healthy over the last 45d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity6/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @nl4ever/sshmcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Sshmcp →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Sshmcp

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (21)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Sshmcp.

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

Documentation Overview

@nl4ever/sshmcp

中文文档

Code

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

Terminal

npm install -g @nl4ever/sshmcp

Add to Claude Code

Terminal

claude mcp add sshmcp sshmcp

Add to Claude Desktop

Edit claude_desktop_config.json:

config.json

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

Add to Cursor

Go to Settings → MCP Servers → Add:

config.json

{
  "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:

Code

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") ← auto-connects to dev, prod stays
AI: execute(server_id="prod", command="curl localhost")           ← reuses prod connection

For temporary servers, use quick_connect which returns host:port as the ID:

Code

AI: quick_connect(host="1.2.3.4", username="root", password="***")
→ "Connected: root@1.2.3.4:22, use server_id="1.2.3.4:22""

AI: execute(server_id="1.2.3.4:22", command="df -h")
AI: disconnect(server_id="1.2.3.4:22")

Async Transfer (Large Files)

For large files, enable background transfer mode to avoid blocking:

Code

AI: upload_file(server_id="prod", local_path="big.tar.gz", remote_path="/data/", async_transfer=true)
→ "Background upload started: tf_1"

AI: transfer_status("tf_1")
→ "🔄 Uploading: 638.2 MB / 1.2 GB (53.2%) — 12.4 MB/s, ETA 46s"

AI: transfer_status("tf_1")
→ "✅ Upload complete: 1.2 GB, 98s, 12.3 MB/s"

Small files use synchronous mode by default — no config needed.

Connection Examples

Password authentication

Code

AI: add_server(server_id="prod", name="Production", host="10.0.0.1", username="deploy", password="***")
AI: execute(server_id="prod", command="systemctl status nginx")

Private key authentication

Code

AI: add_server(server_id="aws", name="AWS EC2", host="ec2-xx.compute.amazonaws.com", username="ubuntu", private_key="~/.ssh/id_rsa")

Quick connect (no config saved)

Code

AI: quick_connect(host="192.168.1.100", username="root", password="***")
→ server_id="192.168.1.100:22"

AI: execute(server_id="192.168.1.100:22", command="df -h")
AI: disconnect(server_id="192.168.1.100:22")

Via SOCKS5 proxy

Code

AI: add_proxy(proxy_id="tunnel", name="SSH Tunnel", host="127.0.0.1", port=1080, type="5")
AI: add_server(server_id="internal", ..., proxy="tunnel")

Via jump host

Code

AI: add_server(server_id="bastion", name="Bastion", host="bastion.example.com", username="admin", private_key="~/.ssh/id_rsa")
AI: add_server(server_id="internal", name="Internal DB", host="10.0.0.5", username="dbadmin", password="***", jump_host="bastion")

Config Location

Server and proxy configurations are stored in:

Code

~/.ssh-mcp/config.json

Passwords are stored in plaintext. For production use, prefer private key authentication.

Requirements

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

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

438

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Sshmcp

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "sshmcp": { "command": "npx", "args": ["-y","@nl4ever/sshmcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/sshmcp?style=directory)](https://allmcps.com/mcp/sshmcp)

HTML Embed

<a href="https://allmcps.com/mcp/sshmcp"><img src="https://allmcps.com/api/badge/sshmcp?style=directory" alt="Sshmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

3/5 checks healthy over the last 45d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity6/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @nl4ever/sshmcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.