MCP SSH Manager enables remote SSH server management via Model Context Protocol. It supports 37 tools for DevOps automation, backups, database operations, and health monitoring. Compatible with Claude Code and OpenAI Codex, it streamlines remote server management for operations teams.
git clone https://github.com/bvisible/mcp-ssh-manager.gitThe mcp-ssh-manager skill is designed for efficient remote SSH management, providing users with 37 tools that facilitate various tasks such as backups, database operations, and health monitoring. Built on Claude Code and powered by OpenAI Codex, this skill simplifies the complexities of managing SSH servers, making it an invaluable asset for DevOps professionals. By automating routine SSH tasks, users can focus on more strategic initiatives, ultimately enhancing productivity. One of the key benefits of the mcp-ssh-manager is its ability to save time on repetitive tasks. Although specific time savings are not quantified, the streamlined processes it offers can significantly reduce the hours spent on SSH management. This skill is particularly beneficial for developers, product managers, and AI practitioners who require reliable and efficient remote server management solutions. By automating these workflows, teams can allocate their resources more effectively and improve overall operational efficiency. Practical use cases for the mcp-ssh-manager include automating health checks on servers, scheduling regular backups, and performing database operations without manual intervention. For instance, a DevOps team can set up automated health monitoring to receive alerts on server performance, allowing them to address issues proactively rather than reactively. This not only enhances server reliability but also minimizes downtime, leading to better service delivery. With an intermediate implementation difficulty, users can expect to set up the mcp-ssh-manager skill in approximately 30 minutes. While the complexity is moderate, the investment of time yields substantial returns in workflow automation. As organizations increasingly adopt AI-first strategies, integrating tools like mcp-ssh-manager into their workflows will be crucial for maintaining competitive advantages in efficiency and responsiveness.
[{"step":"Install and Configure MCP SSH Manager","action":"Ensure the MCP SSH Manager is installed in your AI environment (e.g., via `pip install mcp-ssh-manager` or your package manager). Configure SSH access to the target server by adding the server's IP, username, and authentication method (password or SSH key) to the manager's settings. Test the connection using the `mcp-ssh-manager test_connection` tool.","tip":"Use SSH key authentication for better security and reliability. Store keys in a secure vault (e.g., AWS Secrets Manager) and reference them in your MCP configuration."},{"step":"Define the Task or Command","action":"Specify the exact action you want to perform on the remote server. This could be a single command (e.g., `df -h`), a script (e.g., `backup_script.sh`), or a workflow (e.g., 'update system packages and restart services'). Use the `mcp-ssh-manager execute_command` tool for direct commands or `mcp-ssh-manager run_script` for scripts.","tip":"For complex tasks, break them into smaller steps and validate each step's output before proceeding. Use the `mcp-ssh-manager get_output` tool to retrieve results after execution."},{"step":"Execute and Monitor","action":"Run the task using the MCP SSH Manager. Monitor the output in real-time (if supported) or retrieve it afterward. Check for errors, warnings, or unexpected results. Use the `mcp-ssh-manager list_servers` tool to verify the server's status and `mcp-ssh-manager get_logs` to review historical actions.","tip":"Enable verbose logging during execution to capture detailed output. For long-running tasks, use `mcp-ssh-manager monitor_task` to track progress."},{"step":"Validate and Report","action":"Review the output and validate the results against your expectations. For critical tasks (e.g., backups, deployments), perform a manual check if possible. Generate a summary report using the `mcp-ssh-manager generate_report` tool, including success/failure status, output, and any recommendations.","tip":"Automate report generation for recurring tasks (e.g., daily health checks) by scheduling the MCP SSH Manager to run at specific intervals using a cron job or task scheduler."},{"step":"Handle Failures and Retry","action":"If a task fails, use the `mcp-ssh-manager diagnose_error` tool to analyze the issue. Common fixes include checking server connectivity, verifying permissions, or retrying with adjusted parameters. For persistent issues, review server logs or consult the MCP SSH Manager documentation.","tip":"Implement retry logic for transient failures (e.g., network timeouts). Use exponential backoff to avoid overwhelming the server."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/bvisible/mcp-ssh-managerCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the MCP SSH Manager to [ACTION] on [SERVER_IP] with the following details: [COMMAND_OR_TASK]. Ensure you handle authentication via [METHOD: password/key] and verify the [RESULT_CHECK: success/failure]. Provide a summary of the output and any errors encountered.
Successfully executed the following tasks on server **192.168.1.100** (Ubuntu 22.04, SSH key-authenticated):
1. **Disk Usage Check**
```bash
df -h
```
**Output:**
```
Filesystem Size Used Avail Use% Mounted on
/dev/sda1 50G 22G 26G 46% /
/dev/sdb1 100G 45G 50G 48% /mnt/backup
```
*Analysis:* Root partition (`/`) has 26GB free (46% usage), which is within safe limits. Backup drive (`/mnt/backup`) is at 48%—no immediate action needed.
2. **Database Backup**
```bash
pg_dump -U postgres -d app_db -F c -f /mnt/backup/app_db_$(date +%Y%m%d).dump
```
**Output:**
```
pg_dump: dumping database 'app_db' to file '/mnt/backup/app_db_20240515.dump'
```
*Status:* Backup completed successfully. File size: **1.8GB**. Verified checksum: **SHA256: a1b2c3...**
3. **Service Status Check**
```bash
systemctl status nginx --no-pager
```
**Output:**
```
● nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2024-05-15 08:30:00 UTC; 2h ago
```
*Status:* Nginx is running and healthy.
**Summary:**
- All tasks completed without errors.
- No critical alerts (disk usage, backups, or services).
- Recommendation: Schedule a weekly backup retention cleanup for `/mnt/backup`.
**Errors:** None.Open-source ERP with integrated CRM capabilities
Advanced foundation models via API and ChatGPT
Your one-stop shop for church and ministry supplies.
Free Accounting Software
Global payroll and compliance for distributed teams
Automate your browser workflows effortlessly
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan