What can you do with this server?

This MCP server provides AI assistants with secure remote server management over SSH, including command execution, file transfer, host discovery, and audit capabilities. It offers the following key features: * Command execution: Run single or batch commands on remote hosts, with options for shell selection, timeouts, environment variables, and an explicit allow-dangerous flag. * Host discovery: List configured hosts from ~/.ssh/config and scan networks for SSH-enabled hosts with optional banner detection. * File transfer: Upload/download files and directories with atomic writes, SHA-256 checksums, and sensitive path protection. * Remote file management: List directories, get file stats, create directories, and delete files/directories with recursive options. * Security review modes: Dynamically switch between off, whitelist, manual, and smart modes to control command execution. * Audit logs: Query read-only action logs for monitoring. * Enhanced security: Strict host-key verification, dangerous command interception, credentials redaction, resource limits, and cross-platform support (Windows, Linux, WSL2).

How do I use mcp-ssh?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-ssh run 'ls -la' on myserver" 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.

mcp-ssh

by albertm88

Overview Schema Related Servers Score Discussions

Python

Remote

mcp-ssh

跨平台 SSH MCP 服务器 — 让 AI 助手安全地管理远程服务器。

Python License: GPL v3 MCP

📦 当前文档为 main 分支（完整版）
版本
分支
说明
main（当前）
main
完整版：15 个 MCP 工具（含 ssh_scan 网络扫描、独立文件工具），含质量与安全加固
简化版
lite
11 个 MCP 工具，文件类操作合并为 ssh_filesystem，移除 ssh_scan
极速版
fast
Go 1.26 实现，8 个 MCP 工具，单二进制 ~10MB、启动 ~48ms、零环境依赖

版本：1.0.1（2026-08-10，质量与安全加固）
平台：Windows、Linux（含 WSL2）。macOS 不支持
语言：English | 简体中文

版本家族（一主二分支）

本项目维护三个并行版本，共用同一套 envelope 契约、4 模式审核与防御纵深，客户端可无感切换：

版本	分支	实现	工具数	定位	适用场景
完整版	`main`（本分支）	Python + Paramiko	15	功能最全	需要网络扫描、批量命令、目录传输
简化版	`lite`	Python + Paramiko	11	功能裁剪	文件操作合并、无需扫描
极速版	`fast`	Go 1.26	8	性能优先	单二进制、毫秒启动、零依赖

功能差异对比

能力	main	lite	fast
`ssh_exec` 命令执行	✅	✅	✅
`ssh_upload` / `ssh_download`	✅	✅	✅
`ssh_filesystem`（list/stat/mkdir/remove）	❌ 4 个独立工具	✅ 合并	✅ 合并
`ssh_scan`（网络扫描）	✅	❌	❌
`ssh_exec_batch`（批量命令）	✅	✅	❌
`ssh_upload_dir` / `ssh_download_dir`（目录传输）	✅	✅	❌
`ssh_list_hosts`	✅	✅	✅
审核模式（off/whitelist/manual/smart）	✅	✅	✅
防御纵深（注入/危险命令拦截）	✅	✅	✅
严格 host key 策略	✅	✅	✅
envelope 契约兼容	✅	✅	✅
启动延迟（含握手）	~1749ms	~1749ms	~48ms
部署体积	venv 58MB	venv 58MB	单二进制 10.6MB
环境依赖	Python + uv/venv	Python + uv/venv	零

选择建议：日常管理服务器选 main；追求简洁选 lite；对启动速度和部署体积敏感（如 CI、无 Python 环境）选 fast。

Related MCP server: mcp-ssh

快速开始（5 分钟）

1. 安装依赖

需要 Python 3.10+ 与 uv：

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

2. 获取代码并安装

git clone https://github.com/albertm88/mcp-ssh.git
cd mcp-ssh
uv sync        # 创建虚拟环境并安装依赖

3. 配置 SSH 连接（`~/.ssh/config`）

Host myserver
    HostName 192.168.1.100
    User ubuntu
    IdentityFile ~/.ssh/id_ed25519

ssh myserver "echo ok"          # 先手动验证 SSH 可连
ssh-keyscan -H myserver >> ~/.ssh/known_hosts   # 信任主机密钥（首次必做）

无密钥时可用密码：设置环境变量 SSH_PASS_MYSERVER（别名大写、点/横线转下划线）。本工具默认拒绝未知主机密钥；未预置指纹的连接会失败返回 HOST_KEY_MISMATCH。

4. 配置 MCP 客户端（通用格式）

所有 MCP 客户端（Claude Desktop、VS Code、Cursor、Trae、Qoder、Codex 等）使用同一套 JSON 配置，仅配置文件路径不同：

{
  "mcpServers": {
    "ssh": {
      "command": "uv",
      "args": ["run", "--directory", "/绝对路径/mcp-ssh", "python", "server.py"],
      "env": { "SSH_REVIEW_MODE": "whitelist" }
    }
  }
}

把上面这段 JSON 加入你客户端的 MCP 配置文件：

客户端	配置文件位置
Claude Desktop	`claude_desktop_config.json`（应用设置中打开）
VS Code	工作区 `.vscode/mcp.json` 或用户 `mcp.json`
Cursor	`.cursor/mcp.json`
Claude Code / Codex CLI	`claude mcp add ssh -- uv run --directory $(pwd) python server.py`
其他	在客户端 MCP 设置中添加同名 JSON 块

Windows 注意：路径用 / 或 \\，如 D:/mcp-ssh。配置后重启客户端生效。

5. 验证安装

# 一键验证（环境、依赖、SSH 配置、MCP 握手、真实调用）
uv run python scripts/verify-install.py myserver

期望输出（全部 PASS）：

[1/5] 环境检查        Python / uv
[2/5] 依赖检查        mcp / paramiko / charset_normalizer
[3/5] SSH 配置检查    config 存在、主机别名、known_hosts
[4/5] MCP 协议验证    tools/list → 15 个工具
[5/5] 真实调用验证    ssh_exec(myserver, hostname) → 成功
结果: 12/12 PASS

在 AI 客户端中测试："请用 ssh_list_hosts 查看配置的主机，然后 ssh_exec 执行 hostname"

工具一览（15 个）

类别	工具	说明
命令执行	`ssh_exec` / `ssh_exec_batch`	单条 / 批量执行命令
主机发现	`ssh_list_hosts` / `ssh_scan`	列出配置主机 / 扫描网段
文件传输	`ssh_upload` / `ssh_download` / `ssh_upload_dir` / `ssh_download_dir`	单文件 / 目录传输（原子写 + SHA-256 校验）
远端文件	`ssh_list_dir` / `ssh_stat_file` / `ssh_mkdir` / `ssh_remove`	目录列表 / 状态 / 创建 / 删除
审核管理	`ssh_get_review_mode` / `ssh_set_review_mode`	查看 / 切换审核模式
审计查询	`ssh_get_audit_logs`	查询最近行为日志（只读）

所有工具返回统一 envelope（status / error.code / data / text），详见结果契约。

安全机制

四模式审核（默认 `whitelist`）

模式	行为	适用场景
`off`	全部放行	开发调试
`whitelist`	仅白名单命令	生产（默认）
`manual`	每条命令人工确认	关键服务器
`smart`	智能判断，不确定转人工	日常运维

ssh_get_review_mode()             # 查看当前模式
ssh_set_review_mode("smart")      # 切换模式

manual 模式自动选择确认通道：客户端弹框（支持 elicitation 的 IDE）→ 本地终端 → 无通道时拒绝执行（fail-closed）。

其他安全边界

严格 host-key：未知/错误指纹在认证前拒绝（HOST_KEY_MISMATCH），不自动接受
敏感路径保护：/etc/passwd、~/.ssh/id_* 等禁止读写；路径拒绝 . / .. 组件
资源限制：文件大小 / 目录大小 / 深度 / 扫描地址 / 输出配额，off 模式也不可关闭
凭据脱敏：密码、私钥、环境变量值不入日志；日志中 export K=V 值替换为 ***
危险命令拦截：rm -rf /、mkfs、shutdown 等需 allow_dangerous=True

架构

┌─────────────────┐     stdio      ┌─────────────┐
│   MCP Client    │ ◄────────────► │  mcp-ssh    │
│ (Claude/VSCode/ │                │   Server    │
│  Trae/Qoder/    │                │             │
│  Codex/Cursor)  │                │             │
└─────────────────┘                └──────┬──────┘
                                          │
                    ┌─────────────────────┼─────────────────────┐
                    │                     │                     │
                    ▼                     ▼                     ▼
              ┌──────────┐        ┌──────────┐          ┌──────────┐
              │ SSH Tools│        │  Review  │          │  Logger  │
              │          │        │  Engine  │          │          │
              │ ssh_exec │        │          │          │ JSON-lines│
              │ ssh_scan │        │ 4 modes  │          │ to disk  │
              │ ssh_upload│       │          │          │ (脱敏)    │
              │ ...      │        │ whitelist│          └──────────┘
              └────┬─────┘        │ manual   │
                   │              │ smart    │
                   │              │ off      │
                   │              └────┬─────┘
                   │                   │
                   ▼                   ▼
            ┌─────────────────────────────────┐
            │      Paramiko SSH Client        │
            │  (key auth → password fallback) │
            └─────────────────────────────────┘

环境变量

变量	默认	说明
`SSH_REVIEW_MODE`	`whitelist`	审核模式：off / whitelist / manual / smart
`SSH_PASS` / `SSH_PASS_<HOST>`	-	全局 / 单主机密码
`SSH_KNOWN_HOSTS`	系统 known_hosts	自定义可信主机密钥文件
`SSH_REVIEW_WHITELIST_FILE`	`~/.ssh/mcp-ssh-whitelist.conf`	白名单规则文件
`SSH_REVIEW_MANUAL_CHANNEL`	`auto`	manual 确认通道：elicit / local / auto
`SSH_LOG_FILE` / `SSH_LOG_LEVEL`	`~/.ssh/mcp-ssh.log` / INFO	日志文件与级别

故障排除

问题	解决
`HOST_KEY_MISMATCH`	运行 `ssh-keyscan -H <host> >> ~/.ssh/known_hosts`
`AUTH_FAILED`	检查密钥或 `SSH_PASS_<HOST>` 环境变量
`CONNECTION_LOST` / `CONNECT_TIMEOUT`	先 `ssh <host>` 手动验证可达性
命令被拒绝	切 `smart` 模式或加白名单规则
MCP 客户端无响应	手动运行 `uv run python server.py` 检查报错

项目结构

mcp-ssh/
├── server.py          # MCP 服务器（15 个工具）
├── review.py          # 四模式审核引擎
├── host_keys.py       # 严格主机密钥校验
├── results.py         # 统一结果 envelope
├── logger.py          # 日志（脱敏）
├── scripts/
│   ├── verify-install.py   # 安装验证脚本（跨平台）
│   └── verify-linux.sh     # Linux 本地端回归脚本
└── tests/             # 单元 / 契约 / 边界测试

许可证

GPL v3

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

<1hResponse time

3dRelease cycle

7Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

interminal
Shell Access Command Line
QiuwenZheng
A
license
A
quality
A
maintenance
MCP server for SSH and local terminal access. Supports interactive commands, long-running processes, and TUI apps like tmux/zellij
Updated a month ago (2026-07-13 04:46 UTC)
6
3
MIT
mcp-ssh
Shell Access Command Line Developer Tools
caikiji
A
license
-
quality
D
maintenance
MCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.
Updated 3 months ago (2026-05-08 17:39 UTC)
117
1
MIT
ssh-chat-mcp
Shell Access Command Line
aiplatforms-ru
A
license
A
quality
C
maintenance
Zero-config SSH/SFTP MCP server that lets an LLM client open temporary SSH/SFTP sessions to remote hosts, run commands, and upload/download files without holding any pre-baked credentials.
Updated 3 months ago (2026-05-22 00:53 UTC)
17
9
2
MIT
remote-mcp
Shell Access File Systems Command Line
xiaobright
A
license
-
quality
B
maintenance
一组面向coding agent的MCP服务器，用于在SSH主机和WSL发行版中运行命令、管理任务，并以适合模型使用的方式读写远程文件。
Updated 17 days ago (2026-07-27 10:10 UTC)
13
MIT

View all related MCP servers

Related MCP Connectors

Supabase
MCP server for interacting with the Supabase platform
mcp
MCP (Model Context Protocol) server for Appwrite
server
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

View all MCP Connectors

Appeared in Searches

MCP SSH Reloaded - SSH Server/Tool for Model Context Protocol

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/albertm88/mcp-ssh'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-ssh

版本家族（一主二分支）

功能差异对比

快速开始（5 分钟）

1. 安装依赖

2. 获取代码并安装

3. 配置 SSH 连接（~/.ssh/config）

4. 配置 MCP 客户端（通用格式）

5. 验证安装

工具一览（15 个）

安全机制

四模式审核（默认 whitelist）

其他安全边界

架构

环境变量

故障排除

项目结构

许可证

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

interminal

mcp-ssh

ssh-chat-mcp

remote-mcp

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

3. 配置 SSH 连接（`~/.ssh/config`）

四模式审核（默认 `whitelist`）