# Send MCP SSH Manager to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mcp-ssh-manager",
    "name": "MCP SSH Manager",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/iMaxTomas/mcp-ssh-manager",
    "canonicalUrl": "https://clawhub.ai/iMaxTomas/mcp-ssh-manager",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mcp-ssh-manager",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mcp-ssh-manager",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "examples/deployment.md",
      "examples/system-check.md",
      "examples/troubleshooting.md",
      "references/comparison.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mcp-ssh-manager",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T04:46:40.438Z",
      "expiresAt": "2026-05-12T04:46:40.438Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mcp-ssh-manager",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mcp-ssh-manager",
        "contentDisposition": "attachment; filename=\"mcp-ssh-manager-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mcp-ssh-manager"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mcp-ssh-manager"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mcp-ssh-manager",
    "downloadUrl": "https://openagent3.xyz/downloads/mcp-ssh-manager",
    "agentUrl": "https://openagent3.xyz/skills/mcp-ssh-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mcp-ssh-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mcp-ssh-manager/agent.md"
  }
}
```
## Documentation

### MCP SSH Manager Skill

Original MCP Server: mcp-ssh-manager by @bvisible
This skill provides documentation, workflows, and best practices for using the MCP ssh-manager server.

Manage remote SSH servers using MCP ssh-manager tools. Emphasizes session reuse, workdir organization, and content persistence for sustainable operations.

### Connection Management

TaskToolExampleList serversssh_list_serversssh_list_serversExecute commandssh_executessh_execute server="rock5t" command="df -h"Execute with sudossh_execute_sudossh_execute_sudo server="rock5t" command="apt update"Check statusssh_connection_statusssh_connection_status action="status"

### Session Management

TaskToolExampleStart sessionssh_session_startssh_session_start server="rock5t" name="deploy"Send commandssh_session_sendssh_session_send session="xxx" command="cd /var"List sessionsssh_session_listssh_session_listClose sessionssh_session_closessh_session_close session="xxx"

### File Operations

TaskToolExampleUpload filessh_uploadssh_upload server="rock5t" localPath="." remotePath="/tmp"Download filessh_downloadssh_download server="rock5t" remotePath="/var/log/syslog" localPath="."Sync filesssh_syncssh_sync server="rock5t" source="local:./dist" destination="remote:/var/www"

### Monitoring

TaskToolExampleTail logssh_tailssh_tail server="rock5t" file="/var/log/syslog" lines=20Health checkssh_health_checkssh_health_check server="rock5t"Monitor resourcesssh_monitorssh_monitor server="rock5t" type="overview"Service statusssh_service_statusssh_service_status server="rock5t" services="nginx,docker"

### Tunneling

TaskToolExampleCreate tunnelssh_tunnel_createssh_tunnel_create server="rock5t" type="local" localPort=8080 remoteHost="localhost" remotePort=80List tunnelsssh_tunnel_listssh_tunnel_listClose tunnelssh_tunnel_closessh_tunnel_close tunnelId="xxx"

### Backup

TaskToolExampleCreate backupssh_backup_createssh_backup_create server="rock5t" type="files" name="data"List backupsssh_backup_listssh_backup_list server="rock5t"Restore backupssh_backup_restoressh_backup_restore server="rock5t" backupId="xxx"Schedule backupssh_backup_schedulessh_backup_schedule server="rock5t" schedule="0 2 * * *" type="files" name="daily"

### Example 1: Single Command

# Simple command - no session needed
ssh_execute server="rock5t" command="df -h"

### Example 2: Multi-step Deployment with Session

# Check existing sessions first
ssh_session_list

# Start a persistent session
ssh_session_start server="rock5t" name="deploy"

# Get session ID from previous response
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"

# Close when done
ssh_session_close session="xxx"

### Example 3: System Health Check

# Check overall health
ssh_health_check server="rock5t"

# Monitor specific resources
ssh_monitor server="rock5t" type="cpu" interval=5 duration=30

# Check specific services
ssh_service_status server="rock5t" services="nginx,docker,postgres"

### Example 4: File Deployment

# Upload deployment package
ssh_upload server="rock5t" localPath="./dist/app.tar.gz" remotePath="/tmp/app.tar.gz"

# Extract and restart
ssh_execute server="rock5t" command="cd /tmp && tar -xzf app.tar.gz && cp -r app/* /var/www/ && pm2 restart app"

### Example 5: Log Monitoring

# Tail real-time logs
ssh_tail server="rock5t" file="/var/log/nginx/access.log" lines=50 follow=true

# Filter with grep
ssh_tail server="rock5t" file="/var/log/syslog" grep="error" lines=100

### Example 6: Create SSH Tunnel

# Local port forward (access remote service locally)
ssh_tunnel_create server="rock5t" type="local" localPort=5432 remoteHost="localhost" remotePort=5432

# Now connect to local:5432 to access remote database

### Workdir Management

Store SSH operation results in ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/ for reuse and comparison.

### Structure

~/.ssh-workdir/
└── {hostname}/
    └── {YYYY-MM-DD}-{topic}/
        ├── commands.md    # All executed commands
        ├── output/        # Command outputs
        │   ├── df-h.txt
        │   ├── cpu.txt
        │   └── memory.txt
        ├── status.json    # Host status snapshot
        └── summary.md     # Findings and notes

### Create Workdir

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

# Create commands log
touch ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md

### Log Commands

# Add command to log
echo "## $(date)" >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md
echo 'df -h' >> ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/commands.md

### Save Output

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

### Write Summary

# Write findings
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

### Reuse Previous Context

# Check if recent work exists
ls ~/.ssh-workdir/{hostname}/

# Read previous summary
cat ~/.ssh-workdir/{hostname}/{previous-date}-{topic}/summary.md

# Compare outputs
diff ~/.ssh-workdir/{hostname}/{yesterday}-{topic}/output/df-h.txt \\
     ~/.ssh-workdir/{hostname}/{today}-{topic}/output/df-h.txt

### When to Use Sessions

Use session for:

Multi-step deployments
Tasks requiring state (cd, environment)
Long-running workflows (more than 3 commands)
Tasks where command order matters

Don't use session for:

Single quick commands (df -h, pwd)
Unrelated commands that don't need state
Read-only monitoring tasks

### Session Lifecycle

# 1. Check existing sessions first
ssh_session_list

# 2. Reuse existing session if available and still active
ssh_session_send session="existing-id" command="..."

# 3. Start new session only if necessary
ssh_session_start server="{hostname}" name="{task-name}"

# 4. ALWAYS close when done
ssh_session_close session="{session-id}"

### Timeout Considerations

SSH server may close idle sessions (typically 3-5 minutes by default)
Configure ClientAliveInterval on server for longer keepalive
For long-running tasks, consider periodic lightweight commands to keepalive
If session becomes unresponsive, create a new one

### Before SSH Operations

Check existing sessions
ssh_session_list



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



Create new workdir if starting new task
mkdir -p ~/.ssh-workdir/{hostname}/{YYYY-MM-DD}-{topic}/output

### During SSH Operations

Use appropriate tool for the task

Single command: ssh_execute
Multi-step: ssh_session_start → ssh_session_send → ssh_session_close
File transfer: ssh_upload/download/sync
Monitoring: ssh_monitor, ssh_tail, ssh_health_check



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



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

### After SSH Operations

Close sessions
ssh_session_close session="{session-id}"



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



Clean up

Close tunnels: ssh_tunnel_close
Verify all sessions closed: ssh_session_list

### Tips

Use ssh_session_list before starting new tasks to reuse existing sessions
Create workdir for each task to maintain organized history
Write summaries to quickly recall previous work
Use ssh_connection_status action="status" to check connection health
For server comparison, store outputs with consistent naming across hosts
Close sessions when done to free resources
Configure server-side ClientAliveInterval for longer session timeouts if needed

### Reference Files

references/sessions.md - Session management deep dive
references/workspace.md - Workdir structure and usage
references/comparison.md - How to compare historical data

### Example Files

examples/system-check.md - Complete system health check workflow
examples/deployment.md - Multi-step deployment example
examples/troubleshooting.md - Problem diagnosis workflow

### Scripts

scripts/create-workdir.sh - Create new workdir structure
scripts/log-command.sh - Log command to workdir
scripts/save-status.sh - Capture and save host status
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: iMaxTomas
- Version: 0.1.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T04:46:40.438Z
- Expires at: 2026-05-12T04:46:40.438Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mcp-ssh-manager)
- [Send to Agent page](https://openagent3.xyz/skills/mcp-ssh-manager/agent)
- [JSON manifest](https://openagent3.xyz/skills/mcp-ssh-manager/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mcp-ssh-manager/agent.md)
- [Download page](https://openagent3.xyz/downloads/mcp-ssh-manager)