SSH MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SSH MCP Server run df -h on production servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SSH MCP Server
Let AI clients safely operate your servers โ an SSH-based MCP server
Execute commands and transfer files on remote hosts through standardized MCP tools, with a built-in web admin console and Windows tray application.
What It Does
Connect MCP-compatible AI clients such as Claude Code and Cursor to your SSH servers, and the AI can:
โ๏ธ Execute commands โ remote operations, log troubleshooting, service management
๐ค Upload / ๐ฅ Download files โ configuration distribution, log retrieval, resumable large-file transfers
๐ฅ๏ธ Multi-host management โ a three-level tree of Project โ Environment โ Host, configured once and usable everywhere
Two usage forms, choose as needed:
Form | Suitable Scenarios |
CLI / npm package | Attach to any MCP client as a stdio MCP Server, lightweight and ready to use |
Windows desktop app (recommended) | Pure tray resident + built-in web admin console + online self-update, zero Node.js environment required |
Related MCP server: sshops
โจ Key Features
Connectivity
๐ Multiple authentication methods: password / private key (including encrypted private keys) / SSH Agent / keyboard-interactive 2FA
๐ SOCKS5 and HTTP(S) proxy support, tunneling through jump networks
๐ Dual transfer modes:
execโ one channel per command, for standard Linux hostsshellโ persistent session + marker protocol, adapted for bastion hosts / jump servers
โฑ๏ธ Independent timeouts at three levels: connection / command / SFTP; large files use fastPut/fastGet with segmented concurrency
Security Policy
Command whitelist / blacklist (regex), with both host-level and global-level filtering
Local and remote path whitelists, constraining the scope of file transfers
Full audit logging: commands, outputs, and transfer records are traceable
Web Admin Console
Project-environment-host three-level visual management, with drag-to-sort connections
Test connection, JSON batch import/export, automatic reuse of
~/.ssh/configScheduled backup snapshots and one-click restore; one-click registration of MCP clients (Claude Code, etc.)
Light and dark themes, following the system setting
Windows Desktop App
๐ฏ Pure tray single exe: SSH service, MCP Server, and Admin static site all embedded, no Node.js dependency
Auto-start on boot, keeps running on shutdown; "Open Admin Page" goes straight to the system default browser
๐ Online self-update: built-in minisign signature verification, automatically detects new versions and upgrades silently
๐ธ Interface Overview
Connection Management โ manage all hosts with a three-level tree:
System Page โ service status and one-click MCP client registration:
๐ Quick Start
Option 1: Windows Desktop App
Download SSH-MCP-Server_x.x.x_x64-setup.exe from Releases and install it. After launch, it stays in the system tray; use the tray menu item "Open Admin Page" to enter the web console.
Existing users will be upgraded automatically on subsequent releases, with no manual action needed.
Option 2: npm Package (stdio MCP Server)
# ๅ
จๅฑๅฎ่ฃ
npm install -g @sieop/ssh-mcp-serverRegister it in your MCP client (using Claude Code as an example):
claude mcp add ssh-server -- ssh-mcp-server --host your.server.com --username root --password YOUR_PWDOr write the JSON configuration directly:
{
"mcpServers": {
"ssh-server": {
"command": "npx",
"args": ["-y", "@sieop/ssh-mcp-server", "--host", "your.server.com", "--username", "root", "--password", "YOUR_PWD"]
}
}
}Configuration files and multi-connection mode are also supported; see docs/migration.md and the CLI help (--help) for details.
Option 3: Build from Source
git clone https://github.com/SIE-Operations-and-Maintenance-Team/ssh-mcp-server.git
cd ssh-mcp-server && npm install
npm run build # ๆๅปบ Node ็
npm test # ่ฟ่กๆต่ฏ
npm --prefix admin-web install && npm --prefix admin-web run build # ๆๅปบ็ฎก็ๅฐๅ็ซฏ
npm run tauri:build # ๆๅปบ Windows ๆก้ขๅบ็จ๏ผ้ Rust ๅทฅๅ
ท้พ๏ผ๐งฐ MCP Tools Overview
Tool | Description |
| Execute commands remotely, supporting directory switching, timeout, and output limits, subject to whitelist/blacklist constraints |
| SFTP file transfer with segmented concurrency for large files and path whitelist validation |
| List all available connections |
๐๏ธ Architecture
โโ Windows ๆก้ขๅบ็จ๏ผTauri 2 ็บฏๆ็ๅ exe๏ผโโโโโโโโโโโโโโโโโโโ
โ โ
โ SSH ่ฟๆฅๆฑ โโ MCP StreamableHTTP (/mcp) โ
โ โ โ
โ Admin API (/admin/api/*) โโ ๅ
ๅต้ๆ็ซ็น (/admin/) โ
โ โ
โโโโโโโโโโโโโโโโโโโ ็ณป็ป้ป่ฎคๆต่งๅจๆๅผ็ฎก็้กต โโโโโโโโโโโโโโโโโ
Node ็๏ผnpm ๅ
๏ผ๏ผstdio MCP Server ๏ผ ๅฏ้ --admin ๅฏๅจๅไธๅฅ Web ็ฎก็ๅฐKey modules: src/services/ssh-connection-manager.ts (SSH core), src/server/ (Fastify Admin service), src-tauri/ (Rust desktop shell), admin-web/ (React admin console).
๐ More Documentation
Usage & Migration Guide โ client integration configuration
๐ License
ISC ยฉ SIE Operations and Maintenance Team
This project is derived from classfang/ssh-mcp-server, refactored and extended on its basis.
Available Tools
5 toolsdownloadC
Download file from connected server
Inputs: localPath (required), remotePath (required), connectionName.
execute-commandB
Execute command on connected server and get output result
Inputs: cmdString (required), timeout, directory, connectionName.
list-directoryA
List entries of a remote directory (name, type, size, mtime) via SFTP
Inputs: remotePath (required), connectionName.
list-serversA
List all available SSH server configurations
Inputs: no named parameters.
uploadC
Upload file to connected server
Inputs: localPath (required), remotePath (required), connectionName.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 5 tools
Each tool targets a distinct operation: remote command execution, file upload, file download, server configuration listing, and directory listing. There is no meaningful overlap or ambiguity between them.
Naming mostly follows a clear verb-object pattern with lowercase hyphenation, like execute-command, list-servers, and list-directory. The standalone upload and download verbs deviate slightly from the hyphenated style but remain intuitive and consistent in intent.
Five tools is well-scoped for an SSH MCP server, covering the essential interactions without unnecessary bloat. Each tool earns its place and the set feels focused.
The set covers command execution, file transfer, directory browsing, and server enumeration, which are core SSH workflows. Minor gaps like missing explicit remote delete, rename, or mkdir tools are workable because command execution can handle those operations.
Maintenance
Related MCP Connectors
SSH client, server management and one remote MCP URL for your machines, with human approvals.
1Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Egnyte's remote MCP server for secure AI access, search, upload and file management in your account.
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables remote SSH command execution and bidirectional file transfers through a standardized interface. It allows AI assistants to securely manage remote servers while keeping credentials isolated and applying command-level security controls.ISC
- AlicenseNot gradedqualityDmaintenanceA lightweight, zero-agent SSH operations tool that enables remote command execution, file transfer, and audit logging. It integrates as an MCP server for AI-driven infrastructure management.19 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to perform comprehensive SSH operations including command execution, file transfers, port forwarding, and key management through a stateless, Docker-ready MCP server.15MIT
- AlicenseAqualityDmaintenanceEnables AI tools to manage SSH connections, execute commands, transfer files, and perform remote server diagnostics via MCP protocol.1710 npmMIT