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:

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

🏗️ 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

• Changelog

📄 License

ISC © SIE Operations and Maintenance Team

This project is derived from classfang/ssh-mcp-server, refactored and extended on its basis.