← 返回目录

SSH Manager MCP Server

社区

通过模型上下文协议（MCP）进行 SSH 远程服务器管理

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 227 / 438
Stars: ★ 502 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 3 天前
工具数: 36

52FMRS · D

此服务器提供了广泛的功能，通过 MCP 进行全面的 SSH 管理，适合需要深度自动化 DevOps 流程的团队。虽然提供了安全模式和审计日志，但用户仍需谨慎管理凭据和权限。

最强项 · 文档质量 15/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

9/20

维护活跃度

11/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 仅提供 README 与仓库元数据，未提供源码、package.json、CI 配置或测试文件。无法验证 MCP 初始化、37 个工具的真实行为、错误处理与依赖控制。README 属于不可信证据，且静态校准要求可执行证据，因此不确定性导致扣分。
安全与权限 9/20: 未发现明确红线：示例中的密码均为占位符，README 声称已修复 shell 注入并支持审计日志、只读/受限模式。但默认 unrestricted 模式、密码/口令以明文存于 .env/TOML、远程命令执行面较大，且所有安全声明无法从源码核实，故扣分。
维护活跃度 11/20: README 展示 MIT 许可证、版本 3.7.0、较新的变更日志和安全修复，说明有持续维护迹象；但缺少可验证的提交历史、issue 响应记录、依赖更新证据和安全响应渠道。星标数仅作发现信号，不计分。
文档质量 15/20: README 本身内容详实，覆盖安装、认证、工具参数、安全模式、故障排除、已知限制，并提供 Claude Code 与 Codex 的配置示例，层级化文档引用较多。但所引用的 docs/ 和测试文件无法核实，存在隐藏假设，故未给满分。
安装易用性 12/20: README 提供了 npm/npx 安装、Claude Code 和 Codex 客户端配置示例、.env 与 TOML 示例，安装路径清晰。但静态校准要求可执行证据，而本次未提供 CI 或测试；同时依赖 Node、Bash、rsync/sshpass 等组件，故不高于 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

使用 Claude Code 或 OpenAI Codex 的开发人员和 DevOps 工程师
管理多台服务器并希望自动化日常任务的团队
需要快速执行命令、传输文件或监控系统的运维人员

不适合谁

非技术用户，因为他们需要 SSH 和命令行的基础知识
对安全要求非常严格的环境，如果配置不当，暴露 SSH 凭据可能存在风险
需要在每个服务器上安装代理的用例，因为该服务器直接使用 SSH

所需权限

对本地 SSH 配置和凭据（密码、密钥、ssh-agent）的访问
能够执行远程命令、传输文件、管理数据库和备份
能够创建 SSH 隧道和持久会话
能够读取和修改本地的 .env 和 TOML 配置文件

风险与副作用

凭据在配置文件中可能以明文形式存储，如果配置文件泄露，可能会导致安全漏洞
通过 ssh_execute 执行任意命令可能造成意外更改或损坏
如果使用权限过大，SSH 代理转发可能会将本地密钥暴露给远程主机
网络连接不稳定可能导致命令执行超时或失败

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（7 个）

SSH_SERVER_CI_ALLOW_PATTERNS 可选 restricted 模式下的 ALLOW_PATTERNS 正则白名单示例，可选。

SSH_MANAGER_PROFILE 可选选择别名/钩子配置档案（default/frappe/docker/nodejs），可选。

SSH_CONFIG_PATH 可选 Codex 模式下指向 TOML SSH 配置文件路径，可选。

MCP_SSH_MAX_OUTPUT_LENGTH 可选输出截断长度（默认 10000 字符），性能调优用。

MCP_SSH_DEFAULT_TIMEOUT 可选命令超时毫秒数（默认 120000），可选。

MCP_SSH_COMPACT_JSON 可选设为 true 时用紧凑 JSON 节省 token，可选。

SSH_AUTH_SOCK 可选本地 ssh-agent 套接字，由系统自动设置，存在时自动使用 agent 认证。

安装 Node.js v18 或更高版本，并全局安装 npm 包：npm install -g mcp-ssh-manager。
为 Claude Code 添加 MCP 服务器：claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js。
对于 OpenAI Codex，运行 ssh-manager codex setup 并按照提示配置 TOML 服务器配置。
配置服务器，使用 .env 或 TOML 格式（使用 ssh-manager server add 向导或手动编辑配置文件）。
如果使用某些功能，请安装可选依赖项：rsync（文件同步）、sshpass（rsync 密码认证）。

验证是否装好

运行 claude mcp list 确认 ssh-manager 已注册，然后在客户端里让 AI 调用 ssh_list_servers，能返回你配置的服务器列表即说明连接成功。

常见排障

如果 MCP 工具不可用，请检查 MCP 是否已安装并重启客户端
如果连接失败，请使用 ssh-manager server test [server_name] 测试连接，检查网络、防火墙和 SSH 服务
如果权限被拒绝，请验证用户名和凭据，检查 SSH 密钥权限（chmod 600）
如果输出过大导致客户端挂起，请设置 MCP_SSH_MAX_OUTPUT_LENGTH 或使用 tail/grep 限制输出
对于 Windows 主机，请确保在配置中设置 platform=windows 以避免命令包装问题

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出所有已配置的 SSH 服务器
在生产服务器上执行 df -h
上传 config. 到 production:/etc/app/config.
对 production 执行健康检查，报告 CPU、内存和磁盘状态

工具能力 36

ssh_list_servers 只读

列出所有已配置的 SSH 服务器及其详细信息。

ssh_execute 写入

在远程服务器上执行命令。支持指定工作目录。

ssh_upload 写入

将文件上传到远程服务器。

ssh_download 只读

从远程服务器下载文件。

ssh_sync 写入

使用 rsync 在本地和远程之间双向同步文件。

ssh_deploy 写入

自动处理权限和备份地进行文件部署。

ssh_execute_sudo 破坏性

使用 sudo 权限执行命令，安全地处理密码。

ssh_alias 写入

管理服务器别名。操作：添加、移除、列出。

展开其余 28 个工具

ssh_command_alias 写入

管理常用命令的别名。操作：添加、移除、列出、建议。

ssh_hooks 写入

管理 SSH 操作的自动化钩子。操作：列出、启用、禁用、状态。

ssh_profile 写入

管理不同项目类型的配置档案。操作：列出、切换、当前。

ssh_backup_create 写入

在远程服务器上创建数据库或文件的备份。支持 MySQL、PostgreSQL、MongoDB 和文件系统。

ssh_backup_list 只读

列出远程服务器上所有可用的备份。

ssh_backup_restore 写入

从以前的备份恢复。

ssh_backup_schedule 写入

使用 cron 调度自动备份。

ssh_health_check 只读

在远程服务器上执行全面的健康检查（CPU、内存、磁盘、网络等）。

ssh_service_status 只读

检查服务的状态（nginx、mysql、docker 等）。

ssh_process_manager 破坏性

列出、监控或终止远程服务器上的进程。

ssh_alert_setup 写入

配置健康监控警报和阈值。操作：设置、获取、检查。

ssh_db_dump 只读

在远程服务器上创建数据库转储（支持 MySQL、PostgreSQL、MongoDB）。

ssh_db_import 破坏性

导入 SQL 转储或恢复远程数据库。

ssh_db_list 只读

列出远程服务器上的数据库或表。

ssh_db_query 只读

在远程数据库上执行只读 SQL 查询（仅允许 SELECT）。

ssh_connection_status 只读

检查 SSH 连接状态，并强制重新连接。

ssh_tunnel_create 写入

创建 SSH 隧道（本地/远程端口转发或 SOCKS 代理）。

ssh_tunnel_list 只读

列出活动 SSH 隧道。

ssh_tunnel_close 写入

关闭 SSH 隧道。

ssh_session_start 写入

开始一个持久的 SSH 会话。

ssh_session_exec 写入

在持久会话中执行命令。

ssh_session_end 写入

结束持久 SSH 会话。

ssh_group_execute 写入

在多个服务器上同时执行命令。

ssh_monitor 只读

实时监控 CPU、内存、磁盘和网络。

ssh_tail 只读

跟踪远程文件末尾。

ssh_disk_usage 只读

检查磁盘使用情况。

ssh_network_stats 只读

获取网络统计信息。

ssh_uptime 只读

获取远程服务器的运行时间。

使用场景

通过 AI 助手远程管理多台服务器

自动化 DevOps 任务，如部署和备份

监控服务器健康和性能

执行数据库操作和安全管理

通过 AI 创建和使用 SSH 隧道

支持客户端

Claude Code

Codex

依据项目文档列出，未经本站实测。

详细介绍

一个 MCP 服务器，使 Claude Code 和 OpenAI Codex 能够管理多个 SSH 连接。执行命令、传输文件、管理数据库、创建备份、监控健康状态，并直接从你的 AI 助手中自动化 DevOps 任务。