MCP SSH Manager

🖥️ 智能 SSH 远程运维中枢

基于 MCP 协议的 SSH 远程服务器管理工具,支持会话复用、自动化部署、文件同步与健康监控,适用于可持续运维场景。

收藏
10.9k
安装
2.7k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

MCP SSH Manager 是一款基于 MCP(Model Context Protocol)协议的远程服务器管理技能,通过标准化的工具调用接口,实现 SSH 连接的会话化管理。核心功能包括:

连接与执行:支持单次命令执行(ssh_execute)和持久会话(ssh_session_start/send/close),后者适用于多步骤部署、状态依赖任务;提供 sudo 权限执行能力。

文件操作:涵盖上传(ssh_upload)、下载(ssh_download)、双向同步(ssh_sync),支持本地与远程目录的自动化部署场景。

监控与诊断:内置健康检查(ssh_health_check)、资源监控(ssh_monitor)、服务状态查询(ssh_service_status)及实时日志追踪(ssh_tail)。

网络隧道:支持本地/远程端口转发(ssh_tunnel_create),便于安全访问内网服务如数据库。

备份管理:提供文件级备份创建、恢复与定时任务调度(ssh_backup_schedule)。

工作目录组织:强制规范 ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/ 结构,实现命令日志、输出文件、状态快照与摘要的持久化存储,支持历史对比与审计。

显著优点

  • 会话复用机制:避免频繁建连开销,特别适合 CI/CD 流水线式部署
  • 结构化工作流:工作目录强制规范确保操作可追溯、可复现
  • 全栈运维覆盖:从文件部署到监控告警、从隧道穿透到备份恢复,覆盖典型运维场景
  • MCP 标准化:与 Claude Desktop 等 MCP 客户端原生兼容,工具发现与调用自动化

潜在缺点与局限性

  • 依赖外部 MCP Server:需独立部署 ssh-manager 服务,增加架构复杂度
  • 密钥管理风险:SSH 私钥存储于 MCP Server 端,存在潜在泄露面
  • 会话超时敏感:默认 3-5 分钟空闲超时,长任务需额外保活机制
  • 无内置审计:操作日志依赖工作目录手动记录,缺乏集中化审计能力
  • 平台绑定:深度耦合 MCP 生态,非 MCP 环境无法直接使用

适合人群

  • DevOps 工程师与 SRE 团队,需要自动化服务器部署与监控
  • 个人开发者管理多节点 VPS/云服务器
  • 需要标准化远程操作日志的技术团队

常规风险

  • 凭据泄露:SSH 密钥若配置不当可能被 MCP Server 日志记录
  • 误操作覆盖ssh_syncssh_backup_restore 具备破坏性,缺乏二次确认机制
  • 隧道暴露ssh_tunnel_create 可能将内网服务暴露至本地端口,需配合防火墙规则
  • 会话悬挂:异常断开可能导致远程进程残留,需定期 ssh_session_list 清理

MCP SSH Manager 内容

examples文件夹
references文件夹
scripts文件夹
手动下载zip · 21.1 kB
deployment.mdtext/markdown
请选择文件