Enables deep integration with Linux/Unix systems over SSH, providing tools for remote command execution, persistent interactive sessions, and POSIX file management (read/write, upload/download, directory operations, permissions).
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., "@mcp-server-ssh connect to prod-server and run df -h"
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.
基于 OpenSSH 协议 深度连接与操控 Linux/Unix 系统的 Model Context Protocol (MCP) 服务。为大语言模型（LLM）和自动化智能体（AI Agent）提供安全、可控、无侵入的远程执行与文件管理基础设施。
🌐 零侵入 SSH 协议直连：远程 Linux 主机仅需标准 OpenSSH Server，无需部署任何私有 Agent 或守护进程。
🔑 工业级认证链 & 跳板机：完整支持本地公私钥（id_ed25519 / id_rsa）、SSH-Agent 凭证探测、账密认证以及企业级 ProxyJump 堡垒机/跳板机隧道。
⚡ 双模命令执行引擎：
无状态执行 (ssh_exec)：单次独立执行，环境相互隔离，精准捕获标准输出、标准错误与命令退出码（Exit Code）。
交互式会话 (ssh_session_*)：基于 PTY 伪终端维持持久会话，支持连续状态交互与中断信号（如 \x03 Ctrl+C）。
📁 全功能 POSIX SFTP 管理：覆盖远程文本快速读写（内置防 OOM 阈值）、大文件上传/下载、目录树浏览、属性查看（stat）、递归建删与权限变更（chmod）。
🛡️ 严格安全防御矩阵 (SafetyGuard)：前置规则引擎实时扫描输入命令，精准阻断根目录强删（rm -rf /）、底层磁盘覆写（dd / mkfs）、系统关机重启（reboot / shutdown）及 Fork 炸弹等致命操作。
🎯 智能防爆截断 (OutputTruncator)：对高吞吐日志输出实施 64KB 智能保护，保留前置 8KB 标头与后置 56KB 最新日志/堆栈，杜绝撑爆 LLM 上下文窗口。
🔌 动态连接池 & 开箱即用：支持环境变量预载启动秒连默认主机，同时允许在运行时动态连接、切换和管理多台 Linux 主机。
Related MCP server: SSH MCP Server
Connection)工具名称 | 功能描述 | 核心入参说明 |
| 建立新 SSH 连接或按别名载入 |
|
| 关闭指定的 SSH 连接 |
|
| 列出当前所有活跃连接与默认主机 | 无 |
| 读取本机 | 无 |
Execution)工具名称 | 功能描述 | 核心入参说明 |
| 无状态执行远程命令（主力工具） |
|
| 启动交互式 PTY 伪终端会话 |
|
| 向持久终端写入指令或控制字符 |
|
| 关闭指定的交互终端会话 |
|
Filesystem)工具名称 | 功能描述 | 核心入参说明 |
| 读取远程文本文件（限制最大字节） |
|
| 写入或覆盖远程文件内容 |
|
| 列出远程目录文件与属性元数据 |
|
| 获取文件或目录的详细 POSIX 属性 |
|
| 创建远程目录（支持递归创建） |
|
| 删除远程文件或目录（支持递归删除） |
|
| 将本地文件上传到远程路径 |
|
| 将远程文件下载到本地路径 |
|
在您的 MCP 宿主环境（如 Claude Desktop、Cursor 或 Antigravity）配置文件中增加如下配置：
{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["<path-to-repo>/dist/index.js"],
"env": {
"SSH_HOST": "192.168.1.100",
"SSH_PORT": "22",
"SSH_USER": "root",
"SSH_KEY_PATH": "~/.ssh/id_ed25519"
}
}
}
}{
"mcpServers": {
"ssh": {
"command": "node",
"args": ["<path-to-repo>/dist/index.js"],
"env": {
"SSH_CONFIG_ALIAS": "prod-server"
}
}
}
}flowchart TD
Client["MCP Client (Claude Desktop / Cursor / Antigravity)"]
subgraph MCP_Server["mcp-server-ssh (Node.js / TypeScript)"]
Stdio["Stdio Transport (src/index.ts)"]
subgraph Safety_Module["安全与流控"]
Guard["SafetyGuard (高危命令黑名单过滤)"]
Truncator["OutputTruncator (64KB 尾部保留防爆)"]
end
subgraph Services["核心服务"]
ConnPool["ConnectionPool (多主机连接管理)"]
Exec["ExecService (无状态执行)"]
Session["SessionService (PTY 交互会话)"]
SFTP["SFTPService (文件系统抽象)"]
end
end
subgraph Target["远程主机网络"]
Jump["Bastion / ProxyJump (跳板机)"]
Host["Target Linux Server (sshd)"]
end
Client <==>|JSON-RPC via stdio| Stdio
Stdio --> Safety_Module
Safety_Module --> Services
ConnPool -.->|SSH 隧道| Jump
Jump -.->|转发| Host
ConnPool ==>|SSH2 / SFTP| Host本项目遵循 MIT License 协议开源。
This server cannot be deployed
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
