Skip to main content
Glama

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.

Release CI/CD License: ISC

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 hosts

    • shell โ€” 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/config

  • Scheduled 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-server

Register 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_PWD

Or 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-command

Execute commands remotely, supporting directory switching, timeout, and output limits, subject to whitelist/blacklist constraints

upload / download

SFTP file transfer with segmented concurrency for large files and path whitelist validation

list-servers

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

๐Ÿ“„ 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 tools
downloadC

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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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 Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI tools to manage SSH connections, execute commands, transfer files, and perform remote server diagnostics via MCP protocol.
      17
      10 npm
      MIT