Best for
- Developers and DevOps engineers using Claude Code or OpenAI Codex
- Teams managing multiple servers who want to automate routine tasks
- Sysadmins needing quick command execution, file transfer, or monitoring
S
SSH Manager MCP Server
Community
SSH remote server management via Model Context Protocol
GitHub source repository ↗
52FMRS · D
This server provides a broad feature set for comprehensive SSH management via MCP, suitable for teams needing deep DevOps automation. While security modes and audit logs are offered, users must still carefully manage credentials and permissions.
An MCP server that enables Claude Code and OpenAI Codex to manage multiple SSH connections. Execute commands, transfer files, manage databases, create backups, monitor health, and automate DevOps tasks across your servers — directly from your AI assistant.
Tools
ssh_list_servers
Lists all configured SSH servers with their details.
ssh_execute
Execute commands on remote servers. Supports specifying working directory.
ssh_upload
Upload files to remote servers.
ssh_download
Download files from remote servers.
ssh_sync
Bidirectional file sync with rsync between local and remote.
ssh_deploy
Deploy files with automatic permission and backup handling.
ssh_execute_sudo
Execute commands with sudo privileges, securely handling password.
ssh_alias
Manage server aliases. Actions: add, remove, list.
ssh_command_alias
Manage command aliases for frequently used commands. Actions: add, remove, list, suggest.
ssh_hooks
Manage automation hooks for SSH operations. Actions: list, enable, disable, status.
ssh_profile
Manage configuration profiles for different project types. Actions: list, switch, current.
ssh_backup_create
Create backup of database or files on remote server. Supports MySQL, PostgreSQL, MongoDB, and files.
ssh_backup_list
List all available backups on remote server.
ssh_backup_restore
Restore from a previous backup.
ssh_backup_schedule
Schedule automatic backups using cron.
ssh_health_check
Perform comprehensive health check on remote server (CPU, memory, disk, network, etc.).
ssh_service_status
Check status of services (nginx, mysql, docker, etc.).
ssh_process_manager
List, monitor, or kill processes on remote server.
ssh_alert_setup
Configure health monitoring alerts and thresholds. Actions: set, get, check.
ssh_db_dump
Create database dump/backup on remote server (supports MySQL, PostgreSQL, MongoDB).
ssh_db_import
Import SQL dump or restore database on remote server.
ssh_db_list
List databases or tables on remote server.
ssh_db_query
Execute read-only SQL queries on remote database (only SELECT allowed).
ssh_connection_status
Check SSH connection status and force reconnect.
ssh_tunnel_create
Create SSH tunnel (local/remote port forwarding or SOCKS proxy).
ssh_tunnel_list
List active SSH tunnels.
ssh_tunnel_close
Close SSH tunnel.
ssh_session_start
Start a persistent SSH session.
ssh_session_exec
Execute command in a persistent session.
ssh_session_end
End a persistent SSH session.
ssh_group_execute
Execute commands on multiple servers simultaneously.
ssh_monitor
Real-time monitoring of CPU, memory, disk, and network.
ssh_tail
Tail remote file.
ssh_disk_usage
Check disk usage.
ssh_network_stats
Get network statistics.
ssh_uptime
Get uptime of remote server.
Setup
- Install Node.js v18 or higher and globally install the npm package: npm install -g mcp-ssh-manager. 2. Add the MCP server to Claude Code: claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js. 3. For OpenAI Codex, run ssh-manager codex setup and follow prompts to configure TOML server config. 4. Configure servers using .env or TOML format (use ssh-manager server add wizard or manually edit config files). 5. Install optional dependencies if using certain features: rsync (file sync), sshpass (rsync with password auth).
Fit and risk
Not for
- Non-technical users, as SSH and command-line basics are required
- Highly security-sensitive environments if misconfigured, as SSH credentials exposure is a risk
- Use cases requiring agent installation on each server, as this uses direct SSH
Required permissions
- Access to local SSH config and credentials (passwords, keys, ssh-agent)
- Ability to execute remote commands, transfer files, manage databases and backups
- Ability to create SSH tunnels and persistent sessions
- Ability to read and modify local .env and TOML configuration files
Risks and side effects
- Credentials may be stored in plaintext in config files, posing security risks if files are compromised
- Executing arbitrary commands via ssh_execute can cause unintended changes or damage
- SSH agent forwarding can expose local keys to remote hosts if used with excessive permissions
- Unstable network connections may lead to command timeouts or failures
Troubleshooting
- If MCP tools are not available, check that MCP is installed and restart the client
- If connection fails, test with ssh-manager server test [server_name], check network, firewall, and SSH service
- If permission denied, verify username and credentials, check SSH key permissions (chmod 600)
- If large outputs cause client hanging, set MCP_SSH_MAX_OUTPUT_LENGTH or limit output with tail/grep
- For Windows hosts, ensure platform=windows is set in config to avoid command wrapping issues
Use cases
Manage multiple servers remotely through an AI assistant
Automate DevOps tasks like deployments and backups
Monitor server health and performance
Perform database operations and secure management
Create and use SSH tunnels via AI
Supported clients
Claude CodeFull support
OpenAI CodexFull support