MCP SSH 管理器技能

原始 MCP 服务端: @bvisible 开发的 mcp-ssh-manager

本技能提供关于使用 MCP ssh-manager 服务端的文档、工作流及最佳实践。

使用 MCP ssh-manager 工具管理远程 SSH 服务器。强调会话复用、工作目录（workdir）组织与内容持久化，以支持可持续运维操作。

快速参考

连接管理

会话管理

文件操作

监控

隧道管理

备份

使用示例

示例 1：单条命令

# 简单命令 —— 无需建立会话
ssh_execute server="rock5t" command="df -h"

示例 2：基于会话的多步骤部署

# 首先检查现有会话
ssh_session_list

# 启动一个持久化会话
ssh_session_start server="rock5t" name="deploy"

# 根据上一步响应获取会话 ID
ssh_session_send session="xxx" command="cd /home/imax/project"
ssh_session_send session="xxx" command="git pull origin main"
ssh_session_send session="xxx" command="npm install"
ssh_session_send session="xxx" command="npm run build"
ssh_session_send session="xxx" command="pm2 restart all"

# 完成后关闭会话
ssh_session_close session="xxx"

示例 3：系统健康检查

# 检查整体健康状况
ssh_health_check server="rock5t"

# 监控特定资源指标
ssh_monitor server="rock5t" type="cpu" interval=5 duration=30

# 检查指定服务状态
ssh_service_status server="rock5t" services="nginx,docker,postgres"

示例 4：文件部署

# 上传部署包
ssh_upload server="rock5t" localPath="./dist/app.tar.gz" remotePath="/tmp/app.tar.gz"

# 解压并重启服务
ssh_execute server="rock5t" command="cd /tmp && tar -xzf app.tar.gz && cp -r app/* /var/www/ && pm2 restart app"

示例 5：日志监控

# 实时追踪日志
ssh_tail server="rock5t" file="/var/log/nginx/access.log" lines=50 follow=true

# 结合 grep 过滤关键词
ssh_tail server="rock5t" file="/var/log/syslog" grep="error" lines=100

示例 6：创建 SSH 隧道

# 本地端口转发（在本地访问远程服务）
ssh_tunnel_create server="rock5t" type="local" localPort=5432 remoteHost="localhost" remotePort=5432

# 此时可连接本地 5432 端口访问远程数据库

工作目录（Workdir）管理

将 SSH 操作结果存储于 ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/ 路径下，便于复用与历史对比。

目录结构

~/.ssh-workdir/
└── {hostname}/
    └── {YYYY-MM-DD}-{topic}/
        ├── commands.md    # 所有已执行命令记录
        ├── output/        # 命令输出内容
        │   ├── df-h.txt
        │   ├── cpu.txt
        │   └── memory.txt
        ├── status.json    # 主机状态快照
        └── summary.md     # 发现项与备注说明

创建工作目录

# 创建新 workdir
mkdir -p ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/output

# 创建命令日志文件
touch ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md

记录命令

# 将命令追加至日志
echo "## $(date)" >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md
echo 'df -h' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md

保存输出结果

# 执行命令并保存输出
ssh_execute server="{hostname}" command="df -h" > ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/output/df-h.txt

撰写摘要

# 记录发现项
echo '## System Check Findings' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/summary.md
echo '- Disk usage: 75% on /dev/sda1' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/summary.md
echo '- Memory: 4GB/16GB used' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/summary.md

复用先前上下文

# 检查是否存在近期 workdir
ls ~/.ssh-workdir/{hostname}/

# 查看前一次摘要
cat ~/.ssh-workdir/{hostname}/{previous-date}-{topic}/summary.md

# 对比输出差异
diff ~/.ssh-workdir/{hostname}/{yesterday}-{topic}/output/df-h.txt 
     ~/.ssh-workdir/{hostname}/{today}-{topic}/output/df-h.txt

会话管理指南

何时使用会话

建议在以下场景中使用会话：

• 多步骤部署流程
• 需要保持状态的任务（如 cd、环境变量设置等）
• 长时间运行的工作流（超过 3 条命令）
• 命令执行顺序敏感的任务

不建议在以下场景中使用会话：

• 单次快速命令（如 df -h、pwd）
• 彼此无关、无需共享状态的命令
• 只读型监控类任务

会话生命周期

# 1. 首先检查已有会话
ssh_session_list

# 2. 若存在且仍活跃，则优先复用已有会话
ssh_session_send session="existing-id" command="..."

# 3. 仅当必要时才新建会话
ssh_session_start server="{hostname}" name="{task-name}"

# 4. 完成后务必关闭会话
ssh_session_close session="{session-id}"

超时注意事项

• SSH 服务端可能自动关闭空闲会话（默认通常为 3–5 分钟）
• 可通过配置服务端 ClientAliveInterval 参数延长保活时间
• 对于长时任务，可周期性执行轻量级命令维持连接活跃
• 若会话无响应，请新建会话替代

最佳实践

执行 SSH 操作前

1. 检查现有会话

   ssh_session_list
   

2. 检查近期 workdir

   ls ~/.ssh-workdir/{hostname}/
   

3. 若开启新任务，请创建工作目录

   mkdir -p ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/output
   

执行 SSH 操作中

1. 根据任务类型选用合适工具

   • 单条命令：使用 ssh_execute
   • 多步骤流程：使用 ssh_session_start → ssh_session_send → ssh_session_close
   • 文件传输：使用 ssh_upload/ssh_download/ssh_sync
   • 监控任务：使用 ssh_monitor、ssh_tail、ssh_health_check

2. 将命令记录至 workdir

   echo "command" >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md
   

3. 保存关键输出结果

   ssh_execute server="{hostname}" command="df -h" > ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/output/df-h.txt
   

执行 SSH 操作后

1. 关闭会话

   ssh_session_close session="{session-id}"
   

2. 撰写摘要

   echo '## Findings' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/summary.md
   

3. 清理资源

   • 关闭隧道：ssh_tunnel_close
   • 确认所有会话均已关闭：ssh_session_list

提示

• 启动新任务前，先运行 ssh_session_list 检查并复用已有会话
• 为每个任务单独创建工作目录，以保持历史记录清晰有序
• 撰写 summary.md 可快速回顾过往工作内容
• 使用 ssh_connection_status action="status" 检查连接健康度
• 进行跨主机对比时，请统一各主机输出文件的命名规范
• 任务完成后及时关闭会话，释放系统资源
• 如需更长会话超时时间，可在服务端配置 ClientAliveInterval

附加资源

参考文档

• references/sessions.md —— 会话管理深度指南
• references/workspace.md —— Workdir 目录结构与使用说明
• references/comparison.md —— 历史数据对比方法

示例文档

• examples/system-check.md —— 完整系统健康检查工作流
• examples/deployment.md —— 多步骤部署示例
• examples/troubleshooting.md —— 故障诊断工作流

脚本工具

• scripts/create-workdir.sh —— 自动创建 workdir 目录结构
• scripts/log-command.sh —— 快速将命令写入 workdir 日志
• scripts/save-status.sh —— 捕获并保存主机状态快照