MCP SSH Manager

# Changelog All notable changes to MCP SSH Manager will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [3.0.0] - 2025-10-01 ### 🎉 Major Release - Enterprise DevOps Features This major release transforms MCP SSH Manager into a comprehensive DevOps automation platform with **12 new MCP tools** across three major feature areas. ### Added #### Phase 1: Backup & Restore System (v2.1) - **ssh_backup_create**: Create database or file backups with compression - Supports MySQL, PostgreSQL, MongoDB, and file system backups - Automatic gzip compression and metadata tracking - Configurable retention policies - Auto-creates backup directory if missing - **ssh_backup_list**: List all available backups with detailed metadata - **ssh_backup_restore**: Restore from previous backups with cross-database support - **ssh_backup_schedule**: Schedule automatic backups using cron #### Phase 2: Health Checks & Monitoring (v2.2) - **ssh_health_check**: Comprehensive server health monitoring - CPU, Memory (RAM/Swap), Disk usage for all filesystems - Network statistics, system uptime, load average - Overall health status: healthy/warning/critical - **ssh_service_status**: Monitor services (nginx, mysql, docker, etc.) - Supports systemd and sysv init systems - Returns running/stopped status with PID - **ssh_process_manager**: Process management - List top processes sorted by CPU or memory - Kill processes with configurable signals - **ssh_alert_setup**: Configure health monitoring alerts with custom thresholds #### Phase 3: Database Management (v2.3) - **ssh_db_dump**: Create database dumps (MySQL, PostgreSQL, MongoDB) - Gzip compression and selective table backups - **ssh_db_import**: Import and restore databases - Auto-detection of compressed files - **ssh_db_list**: List databases or tables/collections - Filters system databases automatically - **ssh_db_query**: Execute read-only SQL queries - **Security**: Only SELECT queries allowed - Blocks DROP, DELETE, UPDATE, ALTER operations ### Fixed - **ssh_service_status**: Fixed parsing bug where active services were incorrectly detected as "stopped" - Redirected systemctl output to /dev/null for clean status detection ### Improved - **ssh_backup_create**: Auto-creates backup directory with error handling - Previously required manual creation of `/var/backups/ssh-manager` ### Documentation - Added `docs/BACKUP_GUIDE.md` with comprehensive backup strategies - Added `examples/backup-workflow.js` with 13 real-world examples - Updated README.md and CLAUDE.md with all new tools ### Technical Details - **New Modules**: backup-manager.js (469 lines), health-monitor.js (428 lines), database-manager.js (555 lines) - **Total Lines Added**: ~4,100 lines of production code - **Total Tools**: 37 MCP tools (25 existing + 12 new) - **Supported Databases**: MySQL, PostgreSQL, MongoDB - **Security**: SQL injection prevention, read-only query enforcement ### Breaking Changes None. All existing tools remain fully compatible. --- ## [1.3.0] - 2025-09-04 ### Added - OpenAI Codex compatibility with TOML configuration support - Enhanced documentation visibility for both Claude Code and Codex - Dual configuration format support (.env and TOML) - Badge system in README for platform compatibility --- ## [1.2.0] - 2025-08-12 ### Added - **ssh_deploy** tool for automated file deployment with permission handling - **ssh_execute_sudo** tool for secure sudo command execution - **ssh_alias** tool for managing server aliases - Server alias support - use short names like "prod" instead of full server names - Automatic permission detection for system directories - Backup creation before file deployment - Service restart capability after deployment - Deployment helper functions for complex workflows - Comprehensive deployment guide documentation - Example deployment workflows ### Enhanced - Connection resolution now supports aliases and partial matches - Better error messages with available servers and aliases - Secure sudo password handling (masked in logs) - Support for batch file deployments ### Security - Sudo passwords are never logged in plain text - Automatic masking of sensitive information in command output - Secure temporary file handling during deployments ## [1.1.0] - 2025-08-11 ### Added - Default directory configuration per server - DEFAULT_DIR field in .env configuration - Automatic working directory for commands ### Fixed - Syntax error in index.js (extra parenthesis) ## [1.0.0] - 2025-08-10 ### Initial Release - Core SSH connection management - ssh_execute tool for remote command execution - ssh_upload tool for file uploads - ssh_download tool for file downloads - ssh_list_servers tool to list configured servers - Password and SSH key authentication support - Interactive server configuration tool - Connection testing utility - Pre-commit hooks for code quality - GitHub Actions workflow for CI/CD